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68302 Emulation and Analysis 



The HP 64746 68302 emulator replaces the microprocessor in your embedded 
microprocessor system, also called the target system, so that you can control 
execution and view or modify processor and target system resources. 

The emulator requires an emulation analyzer that captures 64 channels of emulation 
processor bus cycle information synchronously with the processor's clock signal. 
The HP 64703 Emulation Bus Analyzer meets this requirement, and it has an 
external analyzer that captures up to 16 channels of external data. 

You can use the HP 64704 or HP 64794 Emulation Bus Analyzers which have 80 
channels; however, these analyzers do not have external analysis channels. 

You can also use the HP 64706 Emulation Bus Analyzer which has 48 channels. 
Because this analyzer has fewer channels, you cannot capture all the 
microprocessor bus cycle information that you can with the other analyzers. 

With the Emulator, You Can ... 

• Plug into 68302 target systems. 

• Download programs into emulation memory or target system RAM. 

• Display or modify the contents of processor registers and memory resources. 

• Run programs, set up software breakpoints, step through programs, and reset 
the emulation processor. 

With the Analyzer, You Can ... 

• Trigger the analyzer when a particular bus cycle state is captured. States are 
stored relative to the trigger state. 

• Qualify which states get stored in the trace. 

• Prestore certain states that occur before each normal store state. 

• Trigger the analyzer after a sequence of up to 8 events have occurred. 

• Capture data on signals of interest in the target system with the external 
analyzer. 

• Cause emulator execution to break when the analyzer finds its trigger condition. 



With the HP 64700 Card Cage, You Can . 



• Use the RS-422 capability of the serial port and an RS-422 interface card on 
the host computer (HP 98659 for the HP 9000 Series 300) to provide 
upload/download rates of up to 230.4K baud. 

• Easily upgrade HP 64700 firmware by downloading to flash memory. 

With Multiple HP 64700s, You Can ... 

• Start and stop up to 16 emulators at the same time (up to 32 if modifications 
are made). 

• Use the analyzer in one HP 64700 to arm (that is, activate) the analyzers in 
other HP 64700 card cages or to cause emulator execution in other HP 64700 
card cages to break. 

• Use the HP 64700' s BNC connector to trigger an external instrument (for 
example, a logic analyzer or oscilloscope) when the analyzer finds its trigger 
condition, or you can allow an external instrument to arm the analyzer or break 
emulator execution. 

With the Graphical User Interface, You Can ... 

• Use the emulator and analyzer under an X Window System that supports 
OSF/Motif interfaces. 

• Enter commands using pull-down or pop-up menus. 

• Enter, recall, and edit commands using the command line pushbuttons. 

• Enter file names, recalled commands, recalled values, etc., using dialog boxes. 

• Set breakpoints by pointing the mouse cursor on a line in the mnemonic 
memory display and clicking. 

• Create action keys for commonly used commands or command files. 

With the Softkey Interface, You Can ... 

• Use the emulator and analyzer with a terminal or terminal emulator. 

• Quickly enter commands using softkeys, command recall, and command 
editing. 
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In This Book 



This book documents the Graphical User Interface and the Softkey Interface when 
used with the HP 64746 68302 emulator and the HP 64703/704/706/794 analyzer. 
It is organized into five parts whose chapters are described below. 

Part 1 . Quick Start Guide 

Chapter 1 quickly shows you how to use the emulator and analyzer. 

Part 2. User's Guide 

Chapter 2 shows you how to start and exit the HP 64700 interfaces. 

Chapter 3 shows you how to enter commands. 

Chapter 4 shows how to configure the emulator. 

Chapter 5 shows how to plug the emulator into a target system. 

Chapter 6 shows how to use the emulator. 

Chapter 7 shows how to use the analyzer. 

Chapter 8 shows how to use the Software Performance Measurement Tool 
(SPMT) with the analyzer. 

Chapter 9 shows how to use the external state analyzer. 

Chapter 10 shows how to make coordinated measurements. 

Chapter 1 1 shows how to change X resource settings for the Graphical User 

Interface. 

Part 3. Reference 

Chapter 12 describes emulator/analyzer interface commands. 
Chapter 1 3 lists the error messages that can occur while using the 
emulator/analyzer interface. 

Chapter 14 describes emulator specifications and characteristics. 

Part 4. Concept Guide 

Chapter 15 contains conceptual information on various topics. 

Part 5. Installation Guide 

Chapter 16 outlines the installation of the Graphical User Interface, and shows 
you how to start and exit the interface. 
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Getting Started 



Chapter 1 : Getting Started 



The Emulator/Analyzer Interface — At a Glance 

When an X Window System that supports OSF/Motif interfaces is running on the 
host computer, the emulator/analyzer interface is the Graphical User Interface 
which provides pull-down and pop-up menus, point and click setting of 
breakpoints, cut and paste, on-line help, customizable action keys and pop-up recall 
buffers, etc. 

The emulator/analyzer interface can also be the Softkey Interface which is provided 
for several types of terminals, terminal emulators, and bitmapped displays. When 
using the Softkey Interface, commands are entered from the keyboard. 



The Softkey Interface 



Display area. 



Status line. 
Command line. 



: Su ftk.L'y Inter f 



Memory : mnemonic :file = main (module) . "main.c": 



address 


data 






002BCE 


4ES60000 


LINK 


A6, #00000 


002BD2 


4EB9000031 


JSR 


000312A 


002BD8 


4EB9000036 


JSE 


0003694 


002BDE 


4E71 


NOP 




~~M2BE0 


4EB9000031 


JSR 


00031D4 


002BE6-. 


^52B900007B 


ADDQ.L 


#1,0007B36 


002BEC 


4874QP007B 


PEA. L 


0007B36 


002BF2 


4EB900002C 


JSR 


0002C22 


002BF8 


S88F 


ADDQ.L 


#4,A7 


002BFA 


4A3900007B 


TST.B 


0007B42 


002C00 


6708 


BEQ.B 


0002C0A 


002C02 


4EB9000035 


JSR 


0003SD4 


002C08 


4E71 


NOP 




002C0A 


4EB9000036 


JSR 


00036B8 


002C10 


4E71 


NOP 




002C12 


60CC 


BRA. B 


0002BE0 



cws: main . "main . c" 



|di splay memory main mnemonic 



trace 



step display 



modify break 



end 



Display area. Can show memory, data values, analyzer traces, registers, 
breakpoints, status, simulated I/O, global symbols, local symbols, pod commands 
(the emulator's underlying Terminal Interface), error log, or display log. You can 
use the UP ARROW, DOWN ARROW, PAGE UP, and PAGE DOWN cursor keys 
to scroll or page up or down the information in the active window. 
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Status line. Displays the emulator and analyzer status. Also, when error and 
status messages occur, they are displayed on the status line in addition to being 
saved in the error log. 

Command line. Commands are entered on the command line by pressing 
softkeys (or by typing them in) and executed by pressing the Return key. The Tab 
and Shift-Tab keys allow you to move the cursor on the command line forward or 
backward. The Clear line key (or CTRL-e) clears from the cursor position to the 
end of the line. The CTRL-u key clears the whole command line. 



Softkey Interface Conventions 

Example Softkey Interface commands throughout the manual use the following 
conventions: 



bold 

bold italic 

normal 
$ 



Commands, options, and parts of command syntax. 

Commands, options, and parts of command syntax which 
may be entered by pressing softkeys. 

User specified parts of a command. 

Represents the UNIX prompt. Commands which follow 
the "$" are entered at the UNIX prompt. 



<RETURN> 



The carriage return key. 
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The Graphical User Interface 



Menu bar 
Action keys 

Entry buffer 

Entry buffer recall 
button. 

Display area. 

Scroll bar. 

Status line. ~~ 

Command line. 

Command line 
entry area. 

Softkey 
pushbuttons 



_Action keys: [_^£5|55^_J L^!5E^JZLLJ l_Jl^5LLL_J I ? un 3Z]L Step "1° urce 



Hi:wli:lt [';ic:k,inl I iiiuhiliii/Aii.ily/i'i: nmViWMW (mli»:iny) 



File Display Modify Execution Breakpoints Trace Settings 



Help 



| ■= YourKey"T[| Make [|Disp Src Prev| |Run Xferto ( )| | Break [| StepAsm 



J 



Recall 



Memory : mnemonic 
address 1 aha 1 



f i Is 



nai n(modu le) . 





— e>rteTTrvoTdijpdate_5y5tem( ) ; 


- 92 


extern void interrupt_sim( ) ; 


93 


extern void do_sort(); 


94 




95 


main( ) 


96 


t 


97 


i ni t_system( ) ; 




- — proc_spec_i ni t ( ) ; 


99 




100 


whi le < .xrue)_^——— — — ~~ 


102 


update_sy5tem( ) ; 


103 


num_check s++ ; 


104 


i nterrupt_5im(&num_check5) ; 


105 


if (graph) 


106 


graph_data( ) ; 


107 


proc_speci f ic(); 


STATUS: 


cius: main. "main, c" : 



/* update system variables */ 
/* simulate an interrupt */ 
/* sets up ascii array and cal 



is i! 



d l s pi 1 a y m e m □ r y rn a 1 n rn n e m □ n 1 c 



I 



■ j run jj trace jj step jjdisplay j j modify j| break j| end jj ETC — j 

Command: |Return|[Recall Cursor: | Backup [ Forward| [ciear to end]|Clear[ [HelpJ 



Command buttons. Includes command 
recall button. 



Cursor buttons for command line area 
control. 



Menu Bar. Provides pulldown menus from which you select commands. When 
menu items are not applicable, they appear half -bright and do not respond to mouse 
clicks. 

Action Keys. User-defined pushbuttons. You can label these pushbuttons and 
define the action to be performed. 
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Entry Buffer. Wherever you see "()" in a pulldown menu, the contents of the 
entry buffer are used in that command. You can type values into the entry buffer, 
or you can cut and paste values into the entry buffer from the display area or from 
the command line entry area. You can also set up action keys to use the contents of 
the entry buffer. 

Entry Buffer Recall Button. Allows you to recall entry buffer values that have 
been predefined or used in previous commands. When you click on the entry 
buffer Recall button, a dialog box appears that allows you to select values. 

Display Area. Can show memory, data values, analyzer traces, registers, 
breakpoints, status, simulated I/O, global symbols, local symbols, pod commands 
(the emulator's underlying Terminal Interface), error log, or display log. 

Whenever the mouse pointer changes from an arrow to a hand, you can press and 
hold the select mouse button to access popup menus. 

Scroll Bar. A "sticky slider" that allows navigation in the display area. Click on 
the upper and lower arrows to scroll to the top (home) and bottom (end) of the 
window. Click on the inner arrows to scroll one line. Drag the slider handle up or 
down to cause continuous scrolling. Click between the inner arrows and the slider 
handle to page up or page down. 

Status Line. Displays the emulator and analyzer status. Also, when error and 
status messages occur, they are displayed on the status line in addition to being 
saved in the error log. You can press and hold the select mouse button to access the 
Status Line popup menu. 

Command Line. The command line area is similar to the command line in the 
Softkey Interface; however, the graphical interface lets you use the mouse to enter 
and edit commands. 

• Command line entry area. Allows you to enter commands from the 
command line. 

• Softkey pushbuttons. Clicking on these pushbuttons, or pressing softkeys, 
places the command in the command line entry area. You can press and hold 
the select mouse button to access the Command Line popup menu. 

• Command buttons (includes command recall button). The command Return 
button is the same as pressing the carriage return key — it sends the command 
in the command line entry area to the emulator/analyzer. 
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The command Recall button allows you to recall previous or predefined 
commands. When you click on the command Recall button, a dialog box 
appears that allows you to select a command. 

• Cursor buttons for command line area control. Allow you to move the 
cursor in the command line entry area forward or backward, clear to the end of 
the command line, or clear the whole command line entry area. 

You can choose not to display the command line area by turning it off. For the 
most common emulator/analyzer operations, the pulldown menus, popup menus, 
and action keys provide all the control you need. Choosing menu items that require 
use of the command line will automatically turn the command line back on. 

Graphical User Interface Conventions 
Choosing Menu Commands 

This chapter uses a shorthand notation for indicating that you should choose a 
particular menu item. For example, the following instruction 

Choose File— >Load— ^Configuration 

means to first display the File pulldown menu, then display the Load cascade 
menu, then select the Configuration item from the Load cascade menu. 

Based on this explanation, the general rule for interpreting this notation can be 
stated as follows: 

• The leftmost item in bold is the pulldown menu label. 

• If there are more than two items, then cascade menus are involved and all 
items between the first and last item have cascade menus attached. 

• The last item on the right is the actual menu choice to be made. 
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Mouse Button and Keyboard Bindings 

Because the Graphical User Interface runs on different kinds of computers, which 
may have different conventions for mouse buttons and key names, the Graphical 
User Interface supports different bindings and the customization of bindings. 

This manual refers to the mouse buttons using general (or "generic") terms. The 
following table describes the generic mouse button names and shows the default 
mouse button bindings. 



Mouse Button Bindings and Description 



Generic 

Button 

Name 


Bindings: 
HP 9000 


Sun 

SPARCsystem 


Description 


paste 


left 


left 


Paste from the display 
area to the entry buffer. 


command paste 


middle 1 


middle 1 


Paste from the entry 
buffer to the command 
line text entry area. 


select 


right 


right 


Click selects first item in 
popup menus. Press and 
hold displays menus. 


command select 


left 


right 


Displays pulldown menus. 


pushbutton 
select 


left 


left 


Actuates pushbuttons 
outside of the display area. 



Middle button on three-button mouse. Both buttons on two-button mouse. 
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The following tables show the default keyboard bindings. 



Keyboard Key Bindings 



Generic Key Name 


III) IWHUt 


i>un aFAKCsystem 


menu select 


extend char 


extend char 


insert 


insert char 


insert char 


delete 


delete char 


delete char 


left-arrow 


left arrow 


left arrow 


right- arrow 


right arrow 


right arrow 


up- arrow 


up arrow 


up arrow 


down-arrow 


down arrow 


down arrow 


escape 


escape 


escape 


TAB 


TAB 


TAB 
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The Getting Started Tutorial 

This tutorial gives you step-by-step instructions on how to perform a few basic 
tasks using the emulator/analyzer interface. The tutorial examples presented in this 
chapter make the following assumptions: 

• The HP 64746 emulator and HP 64703/704/706/794 analyzer are installed into 
the HP 64700 Card Cage, the HP 64700 is connected to the host computer, and 
the Softkey Interface software has been installed as outlined in the 
"Installation" chapter. 

• The emulator is operating out-of-circuit (that is, not plugged into a target 
system) and contains at least 128 Kbytes of emulation memory. 

The Demonstration Program 

The demonstration program used in this chapter is a simple environmental control 
system. The program controls the temperature and humidity of a room requiring 
accurate environmental control. 
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Step 1 . Start the demo 

A demo program and its associated files are provided with the Graphical User 
Interface. 

1 Change to the demo directory. 

S cd $HP64000/demo/debug_env/hp64746 <RETURN> 
Refer to the README file for more information on the demo program. 

2 Check that "$HP64000/bin" and "." are in your PATH environment variable. To 
see the value of PATH: 

$ echo SPATH <RETURN> 

3 If the Graphical User Interface software is installed on a different type of computer 
than the computer you are using, edit the "platformScheme" resource setting in the 
"Xdefaults.emul" file. 

For example, if the Graphical User Interface will be run on a HP 9000 computer 
and displayed on a Sun SPARCsystem computer, change the platform scheme to 
"SunOS". 

4 Start the emulator/analyzer demo. 

$ Startemul <logical_emul_name> <RETURN> 

This script starts the emulator/analyzer interface (with a customized set of action 
keys), loads a configuration file for the demo program, and then loads the demo 
program. 

The <logical_emul_name> in the command above is the logical emulator name 
given in the HP 64700 emulator device table file ($HP64000/etc/64700tab.net). 
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Step 2: Display the program in memory 

1 If the symbol "main" is not already in the entry buffer, move the mouse pointer to 
the entry buffer (notice the flashing I-beam cursor) and type in "main". 

2 Choose Display— ^Memory— ^Mnemonic (). 

Or, using the command line, enter: 

display memory main mnemonic <RETURN> 



[Hewlett Packard Emulator/Analyzer: emB8302 (m68302) 
File Display Modify Execution Breakpoints Trace Settings Help 



Action keys: | < Demo > [[ Run Xfer til ( ) |Disp Src & Asm [ Patch ( ) 



Disp @>RE G l| Disp Src Prey [| Trace [| Run [| Again" 



(): 



Recall 



Memory rmnemonic :file = mai n(modu le) . "mai n. c" : 
address LaheJ daia. 



91 


extern void update_system( ) ; 


92 


extern void i nterrupt_sim( ) ; 


93 


extern void do_sort(); 


3-1 




95 


mai n( ) 


96 


t 


97 


i ni t_system( ) ; 


98 


proc_spec_i ni t ( ) ; 


99 




100 


ujhi le ( true) 


101 


{ 


102 


update_systern( ) ; 


103 


num_checks++; 


104 


interrupt_sim(&num_checks 


105 


if (graph) 


106 


graph_data( ) ; 


107 


proc_specif ic( ) ; 



/* update system variables */ 
/* simulate an interrupt */ 
/* sets up ascii array and calls jj 



STATUS: cms: main. "main. c" 



The default display mode settings cause source lines and symbols to appear in 
displays where appropriate. Notice you can use symbols when specifying 
expressions. The global symbol "main" is used in the command above to specify 
the starting address of the memory to be displayed. 



33 



Chapter 1 : Getting Started 

Step 3: Run from the transfer address 



Step 3: Run from the transfer address 

The transfer address is the entry address defined by the software development tools 
and included with the program's symbol information. 

• Click on the Run Xfer til () action key. 
Or, using the command line, enter: 

run from trans fsr_address until main <RETURN> 



Memory : @sp :mnemonic :file - mai n(modu le) . "mai n. c" : 
aHHr LaheJ dild 



91 extern void update_system( ) ; /* update system variables */ 

92 extern void i nterrupt_sim( ) ; /* simulate an interrupt */ 

93 extern void do_sort(); /* sets up ascii array and calls 

'34 

95 mai n( ) 
| { 

97 init_system( ) ; 

98 proc_spec_i ni t () ; 
99 

100 whi le (true) 

101 { 

102 update_system( ) ; 

103 num_checks++; 

104 interrupt_sim(&num_checks) ; 

105 if (graph) 

106 graph_data( ) ; 

107 proc_speci f i c( ) ; 



STATUS: M68302 — Running in monitor Software break: 0002bceGsp I ^ T ► 



Notice the message "Software break: <address>" is displayed on the status line and 
that the emulator is "Running in monitor". When you run until an address, a 
breakpoint is set at the address before the program is run. 

Notice the highlighted bar on the screen; it shows the current program counter. 
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Step 4: Step high-level source lines 

You can step through the program by high-level source lines. The emulator 
executes as many instructions as are associated with the high-level program source 
lines. 

1 To step a source line from the current program counter, click on the Step Source 
action key. 

Or, using the command line, enter: 
step source <RETURN> 

Notice that the highlighted bar (the current program counter) moves to the next 
high-level source line. 

2 Step into the "init_system" function by continuing to step source lines, either by 
clicking on the Step Source action key, by clicking on the Again action key which 
repeats the previous command, or by entering the step source command on the 
command line. 



Memory : 
address 


2sp : mnemonic :file - i ni t_system(modu le) . " i ni t_system. c" : 
label data 


26 




27 


void i ni t_va l_arr( ) ; 


28 




28 


voi d 


30 


init systemO 




| /* FUNCTION init_system() */ 


32 


/* Initialize the target values for temperature and humidity */ 


33 


target_temp = 73; 


34 


target_humid = 45; 


35 




36 


/* Intialize the variables indicating the current environment */ 


37 


/* conditions */ 


38 


current_temp = 68; 


38 


current_humi d = 41; 


48 




41 


/* Set starting directions for temp and humid */ 


42 


temp_dir = up; 
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Step 5: Display the previous mnemonic display 

• Click on the Disp Src Prev action key. 
Or, using the command line, enter: 

display memory mnemonic previous_display <RETURN> 

This command is useful, for example, when you have stepped into a function that 
you do not wish to look at — you can display the previous mnemonic display and 
run until the source line that follows the function call. 
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Step 6: Run until an address 

When displaying memory in mnemonic format, a selection in the popup menu lets 
you run from the current program counter address until a specific source line. 

• Position the mouse pointer over the line "proc_spec_init();", press and hold the 
select mouse button, and choose Run Until from the popup menu. 









Hewlett Packard Emulator/Analyzer : emB8302 (m68302) 




J 


File Display 


Modify Execution 


Breakpoints Trace Settings 




Help 




Action keys: 


j < Demo > || 


RunXfertilfJ |DispSrc&Asm 


| Patch ( ) 








< 


Your Key > 


J |^MaJtej&J_o^idJ | 


Step Asm J ^Step Source 


[_Disp Var ( ) 






I 


Disp @RTC 


[I Disp Src Prev || 


Trace Run 


Again 




() 


jriain 








| Recall 



Memory : @sp mnemonic 
address lahej 



fil 
d 



nain(module). "main.c": 



ajLa_ 



91 
92 

93 
94 
95 
96 



99 
100 
101 

109 
103 
104 
105 
106 
107 



extern void update_system( ) ; 
extern void interrupt_sim( ) ; 
extern void do_sort(); 

mainO 



/* update system variables */ 

/* simulate an interrupt */ 

/* sets up ascii array and calls 



proc_spec_i ni t ( ) ; 



iihi le (true) 
C 

update_system( 
num_checks++; 
interrupt_sim( 
if (graph) 

graph_data( 
proc_specif ic( 



STATUS: 



M68302 — Stepping complet 



Choose Action for Highlighted Line 



Set/Clear Software Breakpoint 



Edit Source 



Run Until 



Trace After 
Trace Before 
Trace About 
Trace Until 



_1_ 



Or, using the command line, enter: 

run until main. "main.c" : line 98 <RETURN> 



After the command has executed, notice the highlighted bar indicates the program 
counter has moved to the specified source line. 
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Step 7: Display data values 

1 Position the mouse pointer over "num_checks" in the source line that reads 
"num_checks++;" and click the paste mouse button (notice "num_checks" is cut 
and pasted into the entry buffer). 

2 Click on the Disp Var () action key. 
Or, using the command line, enter: 

display data , num_checks int32 <RETURN> 



Data : update 

address LaheJ type daia. 

B07B36 |_num_checks int32 0 



The "num_checks" variable is added to the data values display and its value is 
displayed as a 32-bit integer. 



38 



Chapter 1 : Getting Started 
Step 8: Display registers 



Step 8: Display registers 



You can display the contents of the processor registers. 



• Choose Display— ^Registers— >basic. 



Or, using the command line, enter: 

display registers basic <RETURN> 



Reg i 5ter5 



Next_PC 002BD8@sp 

st = 2704 <.s. . z. . > 

usp = 00000000 sap = 0000CF94 

bar = BFFF <101> 0x80f f f 000Esd 

scr = 00000F00 I PR HUT NPV RDC ERRE VGE NPVE RMCST EMNS RDCE BCLM 







0 


0 0 0 


0 


0 0 


0 0 8 


0 






FRZW 


FR22 FRZ1 


SRM 


HNDEN HNDCN2 


-0 LPREC LPP16 


LPEN LPCD4-0 






0 


0 0 


0 


1 111 


0 8 


0 00000 


a a 


= 0000759R 


al = 


FFFFFFFF 


a2 


= 00007B6C 


a3 = 00008464 




a 4 


= 00007C2C 


a5 = 


0000F53R 


a6 


= 0000CF94 


a7 = 0008CF94 




dO 


= 00000020 


dl = 


00000020 


d2 


= 0000846C 


d3 = 008B226E 




d4 


= 00000000 


d5 = 


00000000 


d6 


= 00000000 


d7 = 00000000 
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Step 9: Step assembly-level instructions 

You can step through the program one instruction at a time. 

• To step one instruction from the current program counter, click on the Step Asm 
action key. 

Or, using the command line, enter: 
Step <RETURN> 



Reg i st ers 


d4 = 00083000 


d5 = 00000000 d6 = 00000000 


d7 = 00000000 






Step_PC 002BD8C 


!sp JSR p. proc_spec_i ni t 








Next_PC 003694Esp 








st = 2704 <.s. . 


z. . > 








US p = 00000000 


ssp = 0000CF90 








bar = BFFF < 10 1 > 0x00f f f 008(3sd 








scr = 00008FB0 


I PR HNT HPV RDC ERRE VGE HPVE 


RMC3T EMN9 RDCE 


BCLM 






0 0 0 0 0 0 0 


8 8 8 


8 






FRZW FRZ2 FR21 SRM HNDEN HNDCN 


2-8 LPREC LPP16 


LPEN 


LPCD4-0 




0 0 0 0 1 111 


8 0 


8 


00000 


a0 = 0000759R 


al = FFFFFFFF a2 = 00007B6C 


a3 = 00008464 






a4 = 00007C2C 


a5 = 0000F59R a6 = 0000CF94 


a7 = 0888CF90 






d0 = 00000020 


dl = 00000020 d2 = 0080846C 


d3 = 8888226E 






d4 = 00000000 


d5 = 88888888 d6 = 88888800 


d7 = 88880000 







Notice, when registers are displayed, stepping causes the assembly language 
instruction just executed to be displayed. 
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Step 10: Trace the program 

When the analyzer traces program execution, it looks at the data on the emulation 
processor's bus and control signals at each clock cycle. The information seen at a 
particular clock cycle is called a state. 

When one of these states matches the "trigger state" you specify, the analyzer stores 
states in trace memory. When trace memory is filled, the trace is said to be 
"complete." 

1 Click on the Recall button to the right of the entry buffer. 

A selection dialog box appears. You can select from entry buffer values that have 
been entered previously or that have been predefined. 

2 Click on "main" in the selection dialog box, and click the "OK" pushbutton. 
Notice that the value "main" has been returned to the entry buffer. 

3 To trigger on the address "main" and store states that occur after the trigger, choose 
Trace->After (). 

Or, using the command line, enter: 
trace after main <RETURN> 

Notice the message "Emulation trace started" appears on the status line. This 
shows that the analyzer has begun to look for the trigger state which is the address 
"main" on the processor's address bus. 

4 Run the emulator demo program from its transfer address by choosing 
Execution— >Run— >from Transfer Address. 

Or, using the command line, enter: 

run from trans fer_address <RETURN> 
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Notice that now the message on the status line is "Emulation trace complete". This 
shows the trigger state has been found and the analyzer trace memory has been 
filled. 



5 To view the captured states, choose Display— >Trace. 

Or, using the command line, enter: 
display trace <RETURN> 



Label: 



Address 
symhnls 



Opcode or Status w/ Source Lines 
mn e mon i c ^ /symbols 



time count 



ttttttttttttttttttttm 



extern void i nt errupt_sim( ) ; 
extern void do_sort(); 




prog | mai n. rnai n LINK 
sysstacl<+003F98 0000 
sysstack+003F9fl 2262 
prog | mai n+000002 0000 
8888888888mai n. c - line 



i ni t_system( ) ; 



prog|main+000004 JSR 

+005 I sysstack+003F94 0000 

+006 | sysstack+003F36 CFF0 

+007 nroq I mai n+000006 0000 



888888888888888888888888888888888 



/ * simulate an interrupt */ 

/* sets up ascii array and calls combs 



R6, 800000 
sdata wr word 
sdata uur word 
sprog rd word 
97 88888888888888888888888888888888888888888888 



240 


no 


240 


nS 


280 


nS 


240 


nS 



lmt. init_system 
sdata wr word 
sdata uur uuord 



240 
240 



The default display mode settings cause source lines and symbols to appear in the 
trace list. 

Captured states are numbered in the left-hand column of the trace list. Line 0 
always contains the state that caused the analyzer to trigger. 

Other columns contain address information, data values, opcode or status 
information, and time count information. 
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Step 1 1 : Display memory at an address in a 
register 

1 Click on the Disp @REG action key. 

Or, using the command line, enter the name of the command file: 

mematreg <RETURN> 

A command file dialog box appears (or a prompt appears in the command line). 

2 Move the mouse pointer to the dialog box text entry area, type "a7", and click on 
the "OK" button. 

Or, if the prompt is in the command line: 

a7 <RETURN> 



Memory : @sp : 
address 


Dytes 
data 


blocked : update 
: hex 










a =■ c i i 






0 OLE 9 8 


-9F 


00 


00 


7B 


46 


00 


00 


7B 


4E 


. . { 


F . 


. { 


N 


eecEflo- 


-R7 


00 


00 


CF 


38 


00 


00 


30 


6E 




8 . 


. 0 


n 


00CER3- 


-RF 


00 


00 


77 


4D 


00 


00 


CE 


□B 


. . w 


M . 






00CEB0- 


-B7 


00 


00 


00 


80 


00 


00 


08 


Cfi 










00 IE El 8 


-BF 


00 


00 


08 


Cfl 


00 


00 


00 


00 










00CEC0- 


■C7 


00 


00 


00 


00 


00 


00 


00 


00 










00CEC8- 


■CF 


00 


00 


77 


IE 


00 


00 


84 


64 


. . w 






d 


0 Oil EDO 


-□7 


00 


00 


7C 


2C 


4C 


65 


6E 


20 


■ • 1 




e n 




00CED8- 


-OF 


00 


00 


00 


00 


00 


00 


36 


DE 






. 6 




00CEE0- 


•E7 


00 


00 


00 


00 


00 


00 


72 


E8 






. r 




00CEE8- 


-EF 


00 


00 


00 


00 


00 


00 


00 


00 










OOIIEFO 


-F7 


00 


00 


00 


3C 


00 


00 


00 


11 










00CEF8- 


-FF 


00 


00 


77 


IE 


00 


00 


00 


02 










00CF00- 


■87 


00 


00 


00 


00 


00 


00 


08 


CH 










00CF08- 


-0F 


00 


00 


00 


04 


00 


00 


00 


00 










00CF10 


-17 


00 


00 


80 


00 


00 


00 


00 


01 










00CF1B- 


•IF 


00 


00 


CF 


64 


00 


00 


72 


E2 




d . 


. r 
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Step 12: Patch assembly language code 

The Patch () action key lets you patch code in your program. Note that the 

HP AxLS 68000 series assembler must be installed in order to use this action key; 

skip this step if the assembler is not installed. 

1 With "main" still in the entry buffer, click on the Run Xfer til () action key. 

2 To display memory with assembly-level instructions intermixed with the high-level 
source lines, click on the Disp Src & Asm action key. 



Memory : @sp :mnemonic :file = mai n(modu le) 
address label data 


" ma i n . c " : 


92 


extern void i nterrupt_sin 


(); 


/* simulate an interrupt */ 


93 


extern void do_sort(); 




/* sets up ascii array and calls 


91 








95 


mai n( ) 






96 


{ 








(pr|main.main 4E560000 


LINK 


H6, 800000 


97 


init systemO; 






002BD2 


4EB9000031 


JSR 


init. i ni t_system 


99 


proc spec i ni t ( ) ; 






002BD8 


4EB9000036 


JSR 


p. proc_spec_i ni t 


99 








100 


uuhi le (true) 






002BDE 


4E71 


NOP 




101 
102 


C 

update systemf ) ; 






002BE0 


4EB9000031 


JSR 


up. update_system 


103 


num_checks++; 







3 Click on the Patch () action key. 

A window appears and the vi editor is started. Add the line: 

LINK A6, #1234h 

Exit out of the editor, saving your changes. 

The file you just edited is assembled, and the patch main menu appears. Type "a" 
and press <RETURN> to apply the patch. 
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Memory : Bsp :mnemonic :file = mai n(modu le) . "mai n. c" : 



address LaheJ daia 

92 extern void i nterrupt_sim( ) ; /* simulate an interrupt */ 

93 extern void do_sort ( ) ; /* sets up ascii array and calls 
94 

95 mai n ( ) 

96 C 

^M£2^ 4E561234 LINK R6, 801234 

97 init_system( ) ; 

002BD2 4EB9800031 JSR i ni t . i ni t_system 

98 proc_spec_i ni t ( ) ; 

002BD8 4EB900003B JSR p. proc_spec_i ni t 

99 

100 whi le (true) 

002BDE 4E71 NOP 

101 { 

102 update_system( ) ; 

002BE0 4EB9000031 JSR up. update_system 

103 num_checl<s++; 



Notice in the emulator/analyzer interface that the instruction at address "main" has 
changed. 

4 Click on the Patch () action key again. 

A window running the vi editor again appears, allowing you to modify the patch 
code that was just created. Modify the line you added previously to: 

LINK A6, #0 

Exit out of the editor, saving your changes. 

The file you just edited is assembled, and the patch main menu appears. Type "a" 
and press <RETURN> to apply the patch. 

Notice in the emulator/analyzer interface that the instruction at address "main" has 
been changed back to what it was originally. 

When patching a single address, make sure the new instruction takes up the same 
number of bytes as the old instruction; otherwise, you may inadvertently modify 
code that follows. 
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5 Type "main+4 thru main+15" in the entry buffer. 

By entering an address range in the entry buffer (that is, <address> thru <address>) 
before clicking on the Patch () action key, you can modify a patch template file 
which allows you to insert as much or as little code as you wish. 

6 Click on the Patch () action key again. 

A window running the vi editor again appears. Suppose you want to patch the 
demo program so that the proc_spec_init() function is called before the 
init_system() function. Suppose also that there is memory available at address 
8800H. Edit the patch template file as shown below. 

; PCHS700 Assembly Patch File: PCHmain+4 . s 

; Date : Tue Jun 30 14:06:06 MDT 1992 

; Dir : /users/guest/demo/debug_env/hp64746 

; Owner: guest 

INCLUDE PCHSINC.S 
ORG main+4 

BRA patchl ; You may want to change this name! 

ORG 8800h ;You MUST set this address! 

patchl NOP 

; !!!!!!!!! You may need to modify labels and operands of the !!!!!!!!! 
; !!!!!!!!! following code to match your assembler syntax !!!!!!!!! 
; !!!!!!!!! Patching Range: main+4 thru main+15 
; !!!!!!!!! Insert new code here !!!!!!!!! 

JSR _proc_spec_init 

JSR _init_system 

BRA main+16 ; You MUST set this address also! 

Notice that symbols can be used in the patch file. Exit out of the editor, saving 
your changes. 

The file you just edited is assembled, and the patch main menu appears. Type "a" 
and press <RETURN> to apply the patch. 

You can step through the program to view execution of the patch. 
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Step 13: Exit the emulator/analyzer interface 

• To exit the emulator/analyzer interface and release the emulator, choose 
File->Exit->Released. 

Or, using the command line, enter: 
end release_system <RETURN> 
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Starting and Exiting HP 64700 Interfaces 



You can use several types of interfaces to the same emulator at the same time to 
give yourself different views into the target system. 

The strength of the emulator/analyzer interface is that it lets you perform the 
real-time analysis measurements that are helpful when integrating hardware and 
software. 

The C debugger interface (which is a separate product) lets you view the stack 
backtrace and high-level data structures, and it lets you use C language expressions 
and macros. These features are most useful when debugging software. 

The Software Performance Analyzer interface (which is also a separate product) 
lets you make measurements that can help you improve the performance of your 
software. 

These interfaces can operate at the same time with the same emulator. When you 
perform an action in one of the interfaces, it is reflected in the other interfaces. 

Up to 10 interface windows may be started for the same emulator. Only one C 
debugger interface window and one SPA window are allowed, but you can start 
multiple emulator/analyzer interface windows. 

The tasks associated with starting and exiting HP 64700 interfaces are grouped into 
the following sections: 

• Starting the emulator/analyzer interface. 

• Opening other HP 64700 interface windows. 



• Exiting HP 64700 interfaces. 
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Starting the Emulator/Analyzer Interface 

Before starting the emulator/analyzer interface, the emulator and interface software 
must have already been installed as described in the "Installation" chapter. 

This section describes how to: 

• Start the interface. 

• Start the interface using the default configuration. 

• Run a command file on interface startup. 

• Display the status of emulators defined in the 64700tab.net file. 

• Unlock an interface that was left locked by another user. 



To start the emulator/analyzer interface 

• Use the emul700 <emul_name> command. 

If $HP64000/bin is specified in your PATH environment variable (as shown in the 
"Installation" chapter), you can start the interface with the emul700 <emul_name> 
command. The "emul_name" is the logical emulator name given in the HP 64700 
emulator device table ($HP64000/etc/64700tab.net). 

If you are running a window system on your host computer (for example, the X 
Window System), you can run the interface in up to 10 windows. This capability 
provides you with several views into the emulation system. For example, you can 
display memory in one window, registers in another, an analyzer trace in a third, 
and data in the fourth. 
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Examples To start the emulator/analyzer interface for the 68302 emulator: 

S emul700 em68302 <RETURN> 

The "em68302" in the command above is the logical emulator name given in the 
HP 64700 emulator device table file ($HP64000/etc/64700tab.net). 

# Blank lines and the rest of each line after a character are ignored. 

# The information in each line must be in the specified order, with one line 

# for each HP series 64700 emulator. Use blanks or tabs to separate fields. 
# 

# + + + 

# Channel | Logical I Processor | Remainder of Information for the Channel 

# Type I Name I Type I (IP address for LAN connections) 

# + + + 

# lan: em68302 m68302 21.17.9.143 

serial: em68302 m68302 myhost /dev/emcom23 OFF 9600 NONE XON 2 8 



If you're currently running the X Window System, the Graphical User Interface 
starts; otherwise, the Softkey Interface starts. 

The status message shows that the default configuration file has been loaded. If the 
command is not successful, you will be given an error message and returned to the 
UNIX prompt. Error messages are described in the "Error Messages" chapter. 



To start the interface using the default 
configuration 

• Use the emul700 -d <emul_name> command. 

In the emul700 -d <emul_name> command, the -d option says to use the default 
configuration. The -d option is ignored if the interface is already running in 
another window or on another terminal. 
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To run a command file on interface startup 

• Use the emul700 -c <cmd_file> <emul_name> command. 

You can cause command files to be ran upon starting the interface by using the -c 
<cmd_file> option to the emul700 command. 

Refer to the "Using Command Files" section in the "Entering Commands" chapter 
for information on creating command files. 



Examples To start the emulator/analyzer interface and run the "startup" command file: 

S emul700 -c startup em68302 <RETURN> 



To display the status of emulators 

• Use the emul700 -1 or emul700 -lv command. 

The -1 option of the emul700 command lists the status of all emulators defined in 
the 64700tab and 64700tab.net files. If a logical emulator name is included in the 
command, just the status of that emulator is listed. 

You can also use the -v option with the -1 option for a verbose listing of the status 
information. 



Examples To list, verbosely, the status of the emulator whose logical name is "em68302": 

$ emul700 -lv em68302 <RETURN> 

The information may be similar to: 

em68302 - m68302 running; user = guest 

description: M68302 emulation, w/internal analysis, 126Kbytes emul mem 

user interfaces: xdebug, xemul, xperf, skemul, sktiming 
device channel: /dev/emcom23 
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Or, the information may be similar to: 

em68302 - m68302 running; user = guest@myhost 

description: M68302 emulation, w/internal analysis, 126Kbytes emul mem 

user interfaces: xdebug, xemul, xperf, skemul, sktiming 
internet address: 21.17.9.143 



To unlock an interface that was left locked by 
another user 

• Use the emul700 -U <emul_name> command. 

The -U option to the emul700 command may be used to unlock the emulators 
whose logical names are specified. This command will fail if there currently is a 
session in progress. 



Examples To unlock the emulator whose logical name is "em68302": 

S emul700 -U em68302 <RETURN> 
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Opening Other HP 64700 Interface Windows 

The File— >Emul700 menu lets you open additional emulator/analyzer interface 
windows or other HP 64700 interface windows if those products have been 
installed (for example, the software performance analyzer (SPA) interface and the 
high-level debugger interface). 

This section shows you how to: 

• Open additional emulator/analyzer interface windows. 

• Open the high-level debugger interface window. 

• Open the software performance analyzer (SPA) interface window. 



To open additional emulator/analyzer windows 

• To open additional Graphical User Interface windows, choose 

File— >Emur700— ^Emulator/Analyzer under Graphic Windows, or enter the 
emul700 <emul_name> command in another terminal emulation window. 

• To open additional conventional Softkey Interface windows, choose 

File— >Emul700— ^Emulator/Analyzer under Terminal Windows, or enter the 
emul700 -u skemul <emul_name> command in another terminal emulation 
window. 

You can open additional Graphical User Interface windows, or terminal emulation 
windows containing the Softkey Interface. 

When you open an additional window, the status line will show that this session is 
joining a session already in progress, and the event log is displayed. 

You can enter commands in any window in which the interface is running. When 
you enter commands in different windows, the command entered in the first 
window must complete before the command entered in the second window can 
start. The status lines and the event log displays are updated in all windows. 
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To open the high-level debugger interface window 

• Choose File— >Emul700— >High -Level Debugger ... under "Graphic Windows", or 
enter the emul700 -u xdebug <emul_name> command in another terminal 
emulation window. 

For information on how to use the high-level debugger interface, refer to the 
debugger/emulator User's Guide. 



To open the software performance analyzer 
(SPA) interface window 

• Choose File— >Emul700— ^Performance Analyzer ... under "Graphic Windows", or 
enter the emul700 -u xperf <emul_name> command in another terminal 
emulation window. 

For information on how to use the software performance analyzer, refer to the 
Software Performance Analyzer User's Guide. 



58 



Chapter 2: Starting and Exiting HP 64700 Interfaces 
Exiting HP 64700 Interfaces 



Exiting HP 64700 Interfaces 

There are several options available when exiting the HP 764700 interfaces. You 
can simply close one of the open interface windows, or you can exit the debug 
session by closing all the open windows. When exiting the debug session, you can 
lock the emulator so that you can continue later, or you can release the emulation 
system so that others may use it. This section describes how to: 

• Close an interface window. 

• Exit a debug/emulation session. 



To close an interface window 

• In the interface window you wish to close, choose File— >Exit— ^Window. In the 
emulator/analyzer interface command line, enter the end command with no options. 

All other interface windows remain open, and the emulation session continues, 
unless the window closed is the only one open for the emulation session. In that 
case, closing the window ends the emulation session, but locks the emulator so that 
other users cannot access it. 
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To exit a debug/emulation session 

• To exit the interface, save your configuration to a temporary file, and lock the 
emulator so that it cannot be accessed by other users, choose File— >Exit— ^Locked. 
In the emulator/analyzer interface command line, enter the end locked command. 

• To exit the interface and release the emulator for access by other users, choose 
File— >Exit— ^Released. In the emulator/analyzer interface command line, enter the 
end release_system command. 

If you exit the interface locked, the interface saves the current configuration to a 
temporary file and locks the emulator to prevent other users from accessing it. 
When you again start the interface with the emul700 command, the temporary file 
is reloaded, and therefore, you return to the configuration you were using when you 
quit the interface locked. 

Also saved when you exit the interface locked are the contents of the entry buffer 
and command recall buffer. These recall buffer values will be present when you 
restart the interface. 

In contrast, if you end released, you must have saved the current configuration to a 
configuration file (if the configuration has changed), or the changes will be lost. 
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Entering Commands 



When an X Window System that supports OSF/Motif interfaces is running on the 
host computer, the emulator/analyzer interface is the Graphical User Interface 
which provides pull-down and pop-up menus, point and click setting of 
breakpoints, cut and paste, on-line help, customizable action keys and pop-up recall 
buffers, etc. 

The emulator/analyzer interface also provides the Softkey Interface for several 
types of terminals, terminal emulators, and bitmapped displays. When using the 
Softkey Interface, commands are entered from the keyboard. 

When using the Graphical User Interface, the command line portion of the interface 
gives you the option of entering commands in the same manner as they are entered 
in the Softkey Interface. If you are using the Softkey Interface, you can only enter 
commands from the keyboard using the command line. 

The menu commands in the Graphical User Interface are a subset of the commands 
available when using the command line. While you have a great deal of capability 
in the menu commands, you have even more in the command line. 

This chapter shows you how to enter commands in each type of emulator/analyzer 
interface. The tasks associated with entering commands are grouped into the 
following sections: 

• Using menus, the entry buffer, and action keys. 

• Using the command line with the mouse. 

• Using the command line with the keyboard. 

• Using command files. 

• Using pod commands. 

• Forwarding commands to other HP 64700 interfaces. 
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Using Menus, the Entry Buffer, and Action Keys 

This section describes the tasks you perform when using the Graphical User 
Interface to enter commands. This section describes how to: 

• Choose a pulldown menu item using the mouse. 

• Choose a pulldown menu item using the keyboard. 

• Use the popup menus. 

• Use the entry buffer. 

• Copy and paste to the entry buffer. 

• Use action keys. 

• Use dialog boxes. 

• Access help information. 
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To choose a pulldown menu item using the 
mouse (method 1) 

1 Position the mouse pointer over the name of the menu on the menu bar. 

2 Press and hold the command select mouse button to display the menu. 

3 While continuing to hold down the mouse button, move the mouse pointer to the 
desired menu item. If the menu item has a cascade menu (identified by an arrow on 
the right edge of the menu button), then continue to hold the mouse button down 
and move the mouse pointer toward the arrow on the right edge of the menu. The 
cascade menu will display. Repeat this step for the cascade menu until you find the 
desired menu item. 

4 Release the mouse button to select the menu choice. 

If you decide not to select a menu item, simply continue to hold the mouse button 
down, move the mouse pointer off of the menu, and release the mouse button. 

Some menu items have an ellipsis ("...") as part of the menu label. An ellipsis 
indicates that the menu item will display a dialog or message box when the menu 
item is chosen. 
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To choose a pulldown menu item using the 
mouse (method 2) 

1 Position the mouse pointer over the menu name on the menu bar. 

2 Click the command select mouse button to display the menu. 

3 Move the mouse pointer to the desired menu item. If the menu item has a cascade 
menu (identified by an arrow on the right edge of the menu button), then repeat the 
previous step and then this step until you find the desired item. 

4 Click the mouse button to select the item. 

If you decide not to select a menu item, simply move the mouse pointer off of the 
menu and click the mouse button. 

Some menu items have an ellipsis ("...") as part of the menu label. An ellipsis 
indicates that the menu item will display a dialog or other box when the menu item 
is chosen. 



To choose a pulldown menu item using the 
keyboard 

• To initially display a pulldown menu, press and hold the menu select key (for 
example, the "Extend char" key on a HP 9000 keyboard) and then type the 
underlined character in the menu label on the menu bar. (For example, "f for 
"File". Type the character in lower case only.) 

• To move right to another pulldown menu after having initially displayed a menu, 
press the right-arrow key. 
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• To move left to another pulldown menu after having initially displayed a menu, 
press the left-arrow key. 

• To move down one menu item within a menu, press the down-arrow key. 

• To move up one menu item within a menu, press the up-arrow key. 

• To choose a menu item, type the character in the menu item label that is underlined. 
Or, move to the menu item using the arrow keys and then press the <RETURN> 
key on the keyboard. 

• To cancel a displayed menu, press the Escape key. 

The interface supports keyboard mnemonics and the use of the arrow keys to move 
within or between menus. For each menu or menu item, the underlined character in 
the menu or menu item label is the keyboard mnemonic character. Notice the 
keyboard mnemonic is not always the first character of the label. If a menu item 
has a cascade menu attached to it, then typing the keyboard mnemonic displays the 
cascade menu. 

Some menu items have an ellipsis ("...") as part of the menu label. An ellipsis 
indicates that the menu item will display a dialog or other box when the menu item 
is chosen. 

Dialog boxes support the use of the keyboard as well. To direct keyboard input to a 
dialog box, you must position the mouse pointer somewhere inside the boundaries 
of the dialog box. That is because the interface keyboard focus policy is set to 
pointer. That just means that the window containing the mouse pointer receives the 
keyboard input. 

In addition to keyboard mnemonics, you can also specify keyboard accelerators 
which are keyboard shortcuts for selected menu items. Refer to the "Setting X 
Resources" chapter and the "Softkey.Input" scheme file for more information about 
setting the X resources that control defining keyboard accelerators. 
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To choose popup menu items 

1 Move the mouse pointer to the area whose popup menu you wish to access. (If a 
popup menu is available, the mouse pointer changes from an arrow to a hand.) 

2 Press and hold the select mouse button. 

3 After the popup menu appears (while continuing to hold down the mouse button), 
move the mouse pointer to the desired menu item. 

4 Release the mouse button to select the menu choice. 

If you decide not to select a menu item, simply continue to hold the mouse button 
down, move the mouse pointer off of the menu, and release the mouse button. 

The following popup menus are available in the Graphical User Interface: 

• Mnemonic Memory Display. 

• Breakpoints Display. 

• Global Symbols Display. 

• Local Symbols Display. 

• Status Line. 

• Command Line. 
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To place values into the entry buffer using the 
keyboard 

1 Position the mouse pointer within the text entry area. (An "I-beam" cursor will 
appear.) 

2 Enter the text using the keyboard. 

To clear the entry buffer text area from beginning until end, press the <Ctrl>u key 
combination. 



To copy-and-paste to the entry buffer 

• To copy and paste a discrete text string as determined by the interface, position the 
mouse pointer over the text to copy and click the paste mouse button. 

• To specify the exact text to copy to the entry buffer: press and hold the paste mouse 
button; drag the mouse pointer to highlight the text to copy-and-paste; release the 
paste mouse button. 

You can copy-and-paste from the display area, the status line, and from the 
command line entry area. 

When you position the pointer and click the mouse button, the interface expands 
the highlight to include the most complete text string it considers to be discrete. 
Discrete here means that the interface will stop expanding the highlight in a given 
direction when it discovers a delimiting character not determined to be part of the 
string. A common delimiter would, of course, be a space. 

When you press and hold the mouse button and drag the pointer to highlight text, 
the interface copies all highlighted text to the entry buffer when you release the 
mouse button. 

Because the interface displays absolute addresses as hex values, any copied and 
pasted string that can be interpreted as a hexadecimal value (that is, the string 
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contains only numbers 0 through 9 and characters "a" through "f") automatically 
has an "h" appended. 



Note If you have multiple Graphical User Interface windows open, a copy-and-paste 

action in any window causes the text to appear in all entry buffers in all windows. 
That is because although there are a number of entry buffers being displayed, there 
is actually only one entry buffer and it is common to all windows. That means you 
can copy a symbol or an address from one window and then use it in another 
window. 



On a memory display or trace display, a symbol may not be completely displayed 
because there are too many characters to fit into the width limit for a particular 
column of the display. To make a symbol usable for copy-and-paste, you can scroll 
the screen left or right to display all, or at least more, of the characters from the 
symbol. The interface displays absolute addresses as hex values. 

Text pasted into the entry buffer replaces that which is currently there. You cannot 
use paste to append text to existing text already in the entry buffer. 

See "To copy-and-paste from the entry buffer to the command line entry area" for 
information about pasting the contents of the entry buffer into the command line 
entry area. 
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Example To paste the symbol "num_checks" into the entry buffer from the interface display 

area, position the mouse pointer over the symbol and then click the paste mouse 
button. 



A mouse click \ 
causes the interface 
to expand the 
highlight to include 
the symbol 
"num_checks" and 
paste the symbol 
into the entry buffer. 



Hewlett Packard Emulator/Analyzer: em68302 (m68302)| 
File Display Modify Execution Breakpoints Trace Settings 



Help 



Action keys: [^j^JDeino^ 


| Disp Src( ) | Trace ( ) | Run 


|| Step Source j 


| < Your Key > | Make 


||Disp Src Prev |Run Xfer to ( )|| Break 


Jl^^tejpj^mJ 


( ): 


rium_r:hec[:; s 




J Recall 


Memory : mnemonic :file 
address l_ahe_l 


= mai n(modu le) . "mai n. c" : 

daia 






extern void update_system( ) ; 
extern void i nt errupt_sirn( ) ; 
extern void do_sort(); 

mai n( ) 

{ 

i ni t_system( ) ; 
proc_spec_i ni t ( ) ; 



hi le (true) 



/* update system variables */ 
/* simulate an interrupt */ 
/* sets up ascii array and calls! 



update_system( ) ; 



i nterrupt_sim(&num_checl<s) ; 
if (graph) 

graph_data( ) ; 
proc_speci f i c( ) ; 



STATUS: 



cius : ma i n . ma i n . c : 
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To recall entry buffer values 

• Position the mouse pointer over the Recall button just to the right of the entry 
buffer text area, click the mouse button to bring up the Entry Buffer Recall dialog 
box, and then choose a string from that dialog box. 

The Entry Buffer Recall dialog box contains a list of entries gained during the 
emulation session as well as any predefined entries present at interface startup. 

If you exit the emulation/analysis session with the interface "locked", recall buffer 
values are saved and will be present when you restart the interface. 

You can predefine entries for the Entry Buffer Recall dialog box and define the 
maximum number of entries by setting X resources (refer to the "Setting X 
Resources" chapter). 

See the following "To use dialog boxes" section for information about using dialog 
boxes. 



To use the entry buffer 

1 Place information into the entry buffer (see the previous "To place values into the 
entry buffer using the keyboard", "To copy-and-paste to the entry buffer", or "To 
recall entry buffer values" task descriptions). 

2 Choose the menu item, or click the action key, that uses the contents of the entry 
buffer (that is, the menu item or action key that contains "()"). 
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To copy-and-paste from the entry buffer to the 
command line entry area 

1 Place text to be pasted into the command line in the entry buffer text area. 
You may do that by: 

• Copying the text from the display area using the copy-and-paste feature. 

• Enter the text directly by typing it into the entry buffer text area. 

• Choose the text from the entry buffer recall dialog box. 

2 Position the mouse pointer within the command line text entry area. 

3 If necessary, reposition the cursor to the location where you want to paste the text. 

4 If necessary, choose the insert or replace mode for the command entry area. 

5 Click the command paste mouse button to paste the text in the command line entry 
area at the current cursor position. 

The entire contents of the entry buffer are pasted into the command line at the 
current cursor position. 

Although a paste from the display area to the entry buffer affects all displayed entry 
buffers in all open windows, a paste from the entry buffer to the command line only 
affects the command line of the window in which you are currendy working. 

See "To copy-and-paste to the entry buffer" for information about pasting 
information from the display into the entry buffer. 
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To use the action keys 

1 If the action key uses the contents of the entry buffer, place the desired information 
in the entry buffer. 

2 Position the mouse pointer over the action key and click the action key. 

Action keys are user-definable pushbuttons that perform interface or system 
functions. Action keys can use information from the entry buffer — this makes it 
possible to create action keys that are more general and flexible. 

Several action keys are predefined when you first start the Graphical User Interface. 
You can use the predefined action keys, but you'll really appreciate them when you 
define and use your own. 

Action keys are defined by setting an X resource. Refer to the chapter "Setting X 
Resources" for more information about creating action keys. 



To use dialog boxes 

1 Click on an item in the dialog box list to copy the item to the text entry area. 

2 Edit the item in the text entry area (if desired). 

3 Click on the "OK" pushbutton to make the selection and close the dialog box, click 
on the "Apply" pushbutton to make the selection and leave the dialog box open, or 
click on the "Cancel" pushbutton to cancel the selection and close the dialog box. 

The graphical interface uses a number of dialog boxes for selection and recall: 

Directory Selection Selects the working directory. You can change to a 

previously accessed directory, a predefined directory, or 
specify a new directory. 
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File Selection From the working directory, you can select an existing file 

name or specify a new file name. 

Entry Buffer Recall You can recall a previously used entry buffer text string, a 
predefined entry buffer text string, or a newly entered entry 
buffer string, to the entry buffer text area. 

Command Recall You can recall a previously executed command, a 

predefined command, or a newly entered command, to the 
command line. 

The dialog boxes share some common properties: 

• Most dialog boxes can be left on the screen between uses. 

• Dialog boxes can be moved around the screen and do not have to be positioned 
over the graphical interface window. 

• If you iconify the interface window, all dialog boxes are iconified along with 
the main window. 

Except for the File Selection dialog box, predefined entries for each dialog box 
(and the maximum number of entries) are set via X resources (refer to the "Setting 
X Resources" chapter). 
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Examples 



To use the File Selection dialog box: 



The file filter selects 
specific files. 

A list of 

filter-matching files 
from the current 
directory. 

A list of files 
previously accessed \ 
during the emulation 
session. 

A single click on a 
file name from either 
list highlights the file 
name and copies it to 
the text area. A 
double click chooses 
the file and closes the 
dialog box. 

Label informs you 
what kind of file 
selection you are 
performing. 

Text entry area. 
Text is either 
copied here from 
the recall list, or 
entered directly. 




{Emulator/Analyzer: File Selection! 



Filter 



/users/guest/demo/debug_env/hp64746/* . Efl 



Files 



fusers/guest/demo/debug_env/hp64746/Config.EA 
iusers/guest/de mo/debug env/hp64746/Configall.EA 

<Previous Files> 

fusers/guest/demo/debug env/hp64746/Config.EA 



/users/quest/demo/debuq env/hp64746/Confiqall.EA 



Load Emulation Configuration 



OK 



Filter 



Cancel 



Clicking this button 
chooses the file name 
displayed in the text entry 



Entering a new file filter 
and clicking this button 
causes a list of files 



Clicking this button 
cancels the file selection 
operation and closes the 



area and closes the dialog matching the new filter to dialog box. 



box. 



be read from the directory. 
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Label informs you 
of the type of list 
displayed. 

A list of predefined 
or previously 
accessed directories> 



A single click on a x 
directory name from 
the list highlights 
the name and copies 
it to the text area. A 
double click chooses 
the directory and 
closes the dialog 
box. 



Text entry area. 
Directory name is 
either copied here 
from the recall list, 
or entered directly. 



To use the Directory Selection dialog box: 



{Emulator/Analyzer: Directory Selection 



Previous Working Directories 



# Associated X Resource: "emul.m68000*dirSelectSub.entr 
HOME 

HP64000/monitor 
$HP64000/demo/debug_env/hp64746 



lu s e rs/q u e st/d e m o/d e b u q e n v/h p64746 




Selection 

/ users/ que 




st/ demo/ debug_env/hp64746 



Apply 



Cancel 



Clicking this button 
chooses the directory 
displayed in the text entry 
area and closes the dialog 
box. 



Clicking this button 
chooses the directory 
displayed in the text entry 
area, but keeps the dialog 
box on the screen instead 
of closing it. 



Clicking this button 
cancels the directory 
selection operation and 
closes the dialog box. 
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To access help information 

1 Display the Help Index by choosing Help— ^General Topic... or Help— ^Command 
Line.... 

2 Choose a topic of interest from the Help Index. 

The Help Index lists topics covering operation of the interface as well other 
information about the interface. When you choose a topic from the Help Index, the 
interface displays a window containing the help information. You may leave the 
window on the screen while you continue using the interface. 
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Using the Command Line with the Mouse 

When using the Graphical User Interface, the command line portion of the interface 
gives you the option of entering commands in the same manner as they are entered 
in the Softkey Interface. Additionally, the graphical interface makes the softkey 
labels pushbuttons so commands may be entered using the mouse. 

If you are using the Softkey Interface, using the command line with the keyboard is 
the only way to enter commands. 

This section describes how to: 

• Turn the command line off/on. 

• Enter commands. 

• Edit commands. 

• Recall commands. 

• Display the help window. 



To turn the command line on or off 

• To turn the command line on or off using the pulldown menu, choose 
Settings— ^Command Line. 

• To turn the command line on or off using the status line popup menu: position the 
mouse pointer within the status line area, press and hold the select mouse button, 
and choose Command Line Off from the menu. 

• To turn the command line off using the command line entry area popup menu: 
position the mouse pointer within the entry area, press and hold the select mouse 
button, and choose Command Line Off from the menu. 

Turns display of the command line area "on" or "off." On means that the command 
line is displayed and you can use the softkey label pushbuttons, the command 
return and recall pushbuttons, and the cursor pushbuttons for command line editing. 
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Off means the command line is not displayed and you use only the pulldown menus 
and the action keys to control the interface. 

The command line area begins just below the status line and continues to the 
bottom of the emulator/analyzer window. The status line is not part of the 
command line and continues to be displayed whether the command line is on or off. 

Choosing certain pulldown menu items while the command line is off causes the 
command line to be turned on. That is because the menu item chosen requires 
some input at the command line that cannot be supplied another way. 



To enter a command 

1 Build a command using the softkey label pushbuttons by successively positioning 
the mouse pointer on a pushbutton and clicking the pushbutton select mouse button 
until a complete command is formed. 

2 Execute the completed command by clicking the Return pushbutton (found near 
the bottom of the command line in the "Command" group). 

Or: 

Execute the completed command using the Command Line entry area popup menu: 
Position the mouse pointer in the command line entry area; press and hold the 
select mouse button until the Command Line popup menu appears; then, choose the 
Execute Command menu item. 

You may need to combine pushbutton and keyboard entry to form a complete 
command. 

A complete command is a string of softkey labels and text entered with the 
keyboard. You know a command is complete when Return pushbutton is not 
halfbright. The interface does not check or act on a command, however, until the 
command is executed. (In contrast, commands resulting from pulldown menu 
choices and action keys are supplied with the needed carriage return as part of the 
command.) 
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To edit the command line using the command 
line pushbuttons 

• To clear the command line, click the Clear pushbutton. 

• To clear the command line from the cursor position to the end of the line, click the 
Clear to end pushbutton. 

• To move to the right one command word or token, click the Forward pushbutton. 

• To move to the left one command word or token, click the Backup pushbutton. 

• To insert characters at the cursor position, press the insert key to change to 
insertion mode, and then type the characters to be inserted. 

• To delete characters to the left of the cursor position, press the <BACKSPACE> 

key. 

When the cursor arrives at the beginning of a command word or token, the softkey 
labels change to display the possible choices at that level of the command. 

When moving by words left or right, the Forward pushbutton becomes halfbright 
and unresponsive when the cursor reaches the end of the command string. 
Similarly, the Backup pushbutton becomes halfbright and unresponsive when the 
cursor reaches the beginning of the command. 

See "To edit the command line using the mouse and the command line popup 
menu" and "To edit the command line using the keyboard" for information about 
additional editing operations you can perform. 
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To edit the command line using the command 
line popup menu 

• To clear the command line: position the mouse pointer within the Command Line 
entry area; press and hold the select mouse button until the Command Line popup 
menu appears; choose Clear Entire Line from the menu. 

• To clear the command line from the cursor position to the end of the line: position 
the mouse pointer at the place where you want the clear-to-end to start; press and 
hold the select mouse button until the Command Line popup menu appears; choose 
Clear to End of Line from the menu. 

• To position the cursor and insert characters at the cursor location: position the 
mouse pointer in a non-text area of the command line entry area; press and hold the 
select mouse button to display the Command Line popup menu; choose Position 
Cursor, Insert Mode from the menu; type the characters to be inserted. 

• To replace characters at the current cursor location: position the mouse pointer in a 
non-text area of the command line entry area; press and hold the select mouse 
button to display the Command Line popup menu; choose Position Cursor, 
Replace Mode from the menu; type the characters to be inserted. 

• To position the cursor and replace characters at the cursor location: position the 
mouse pointer in a non-text area of the command line entry area; press and hold the 
select mouse button to display the Command Line popup menu; choose Position 
Cursor, Replace Mode from the menu; type the characters to be inserted. 

When the cursor arrives at the beginning of a command word or token, the softkey 
labels change to display the possible choices at that level of the command. 

See "To edit the command line using the mouse and the command line 
pushbuttons" and "To edit the command line using the keyboard" for information 
about additional editing operations you can perform. 
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To recall commands 

1 Click the pushbutton labeled Recall in the Command Line to display the dialog box. 

2 Choose a command from the buffer list. (You can also enter a command directly 
into the text entry area of the dialog box.) 

Because all command entry methods in the interface — pulldown menus, action 
keys, and command line entries — are echoed to the command line entry area, the 
contents of the Command Recall dialog box is not restricted to just commands 
entered directly into the command line entry area. 

The Command Recall dialog box contains a list of interface commands executed 
during the session as well as any predefined commands present at interface startup. 

If you exit the emulation/analysis session with the interface "locked", commands in 
the recall buffer are saved and will be present when you restart the interface. 

You can predefine entries for the Command Recall dialog box and define the 
maximum number of entries by setting X resources (refer to the "Setting X 
Resources" chapter). 

See "To use dialog boxes" for information about using dialog boxes. 



To get help about the command line 

• To display the help topic explaining the operation of the command line, press the 
Help pushbutton located near the bottom-right corner of the Command Line area. 
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Using the Command Line with the Keyboard 

When using the command line with the keyboard, you enter commands by pressing 
softkeys whose labels appear at the bottom of the screen. Softkeys provide for 
quick command entry, and minimize the possibility of errors. 

The command line also provides command completion. You can type the first few 
characters of a command (enough to uniquely identify the command) and then 
press <Tab>. The interface completes the command word for you. 

Entering commands with the keyboard is easy. However, the interface provides 
other features that make entering commands even easier. For example, you can: 

• Enter multiple commands on one line. 

• Recall commands. 

• Edit commands. 

• Access on-line help information. 



To enter multiple commands on one command 
line 

• Separate the commands with semicolons (;). 

More than one command may be entered in a single command line if the commands 
are separated by semicolons (;). 

Examples To reset the emulator and break into the monitor: 

reset ; break <RETURN> 
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To recall commands 

• Press <CTRL>r or <CTRL>b. 

The most recent 20 commands you enter are stored in a buffer and may be recalled 
by pressing <CTRL>r. Pressing <CTRL>b cycles forward through the recall buffer. 



Examples For example, to recall and execute the command prior to the last command: 

<CTRL>r <CTRL>r <RETURN> 



To edit commands 

• Use the <Left arrow>, <Right arrow>, <Tab>, <ShiftxTab>, <Insert char>, <Back 
space>, <Delete char>, <Clear lino, and <CTRL>u keys. 

The <Left arrow> and <Right arrow> keys move the cursor single spaces to the left 
or right. 

The <Tab> and <ShiftxTab> keys move the cursor to the next or previous word 
on the command line. 

The <Insert char> key enters the insert editing mode and allows characters or 
command options to be inserted at the cursor location. 

The <Back space> key deletes the character to the left of the cursor. 

The <Delete char> key deletes the character to the right of the cursor. 

The <Clear lino key deletes the characters from the cursor to the end of the line. 

The <CTRL>u key erases the command line. 
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To access on-line help information 

• Use the help or ? commands. 

To access the command line's on-line help information, type either help or ? on the 
command line. You will notice a new set of softkeys. By pressing one of these 
softkeys and <RETURN>, you can display information on that topic. 



Examples To display information on the system commands: 

help syst&m_commands <RETURN> 

Or: 

? system_commands <RETURN> 

The help information is scrolled on to the screen. If there is more than a screen full 
of information, you will have to press the space bar to see the next screen full, or 
the <RETURN> key to see the next line, just as you do with the UNIX more 
command. After all the information on the particular topic has been displayed (or 
after you press "q" to quit scrolling through information), you are prompted to press 
<RETURN> to return to the command line. 
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Using Command Files 

You can execute a series of commands that have been stored in a command file. 
You can create command files by logging commands while using the interface or 
by using an editor on your host computer. 

Once you create a command file, you can execute the file in the emulation 
environment by typing the name of the file on the command line and pressing 
<RETURN>. 

Command files execute until an end-of-file is found or until a syntax error occurs. 
You can stop a command file by pressing <CTRL>c or the <Break> key. 

This section shows you how to: 

• Start logging commands to a command file. 

• Stop logging commands to a command file. 

• Playback (execute) a command file. 

Nesting Command Files 

You can nest a maximum of eight levels of command files. Nesting command files 
means one command file calls another. 

Comments in Command Files 

Text that follows a pound sign (#), up to the end of the line, is interpreted as a 
comment. 

Using the wait Command 

When editing command files, you can insert wait commands to pause execution of 
the command file at certain points. 

If you press <CTRL>c to stop execution of a command file while the "wait" 
command is being executed from the command file, the <CTRL>c will terminate 
the "wait" command, but will not terminate command file execution. To do this, 
press <CTRL>c again. 
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Use the wait measurement_complete command after changing the trace depth. 
By doing this, when you copy or display the trace after changing the trace depth, 
the new trace states will be available. Otherwise the new states won't be available. 

Passing Parameters 

Command files provide a convenient method for passing parameters by using a 
parameter declaration line preceding the commands in the command file. When the 
command file is called, the system will prompt you for current values of the formal 
parameters listed. 

Parameters are defined as: 

Passed Parameters - These are ASCII strings passed to a command file. Any 
continuous set of ASCII characters can be passed. Spaces separate the 
parameters. 

Formal Parameters - These are symbols preceded by an ampersand (&), 
which are the variables of the command file. 

The ASCII string passed (passed parameter) will be substituted for the formal 
parameter when the command file is executed. 

The only way to pass a parameter containing a space is to enclose the parameter in 
double quotes (") or single quotes ('). Thus, to pass the parameter HP 9000 to a 
command file, you can use either "HP 9000" or 'HP 9000'. 

The special parameter &ArG_lEfT gets set to all the remaining parameters 
specified when the command file was invoked. This lets you use variable size 
parameter lists. If no parameters are left, &ArG_lEfT gets set to NULL. 

Consider the command file example (named CMDFILE) shown below: 

PARMS SADDR S VALUE 1 
# 

# modify a location or list of locations in memory 

# and display the result 
# 

modify memory SADDR words to & VALUE 1 &ArG_lEfT 
display memory SADDR blocked words 
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When you execute CMDFILE, you will be prompted with: 

Define command file parameter [&ADDR] 

To pass the parameter, enter the address of the first memory location to be 
modified. You will then be prompted for &VALUE1. If you enter, for example, 
"0,-1,20, Offffh, 4+5*4", the first parameter "0,-1,20," is passed to &VALUE1 and 
the remaining parameters "Offffh," and "4+5*4" are passed to &ArG_lEfT. 

You can also pass the parameters when you invoke the command file (for example, 
CMDFILE lOOOh 0,-1,20, Offffh, 4+5*4). 

Other Things to Know About Command Files 

You should know the following about using command files: 

1 Command files may contain shell variables. Only those shell variables 
beginning with "$" followed by an identifier will be supported. An identifier is 
a sequence of letters, digits or underscores beginning with a letter or 
underscore. The identifier may be enclosed by braces " { } " or entered directly 
following the "$" symbol. Braces are required when the identifier is followed 
by a letter, a digit or an underscore that is not interpreted as part of its name. 

For example, assume a directory named /users/softkeys and the shell variable 
"S". The value of "S" is "soft". By specifying the directory as /users/${S}keys 
the correct result is obtained. However, if you attempt to specify the directory 
as /users/$Skeys, the Softkey Interface looks for the value of the variable 
"Skeys". This is not the operators intended result. You may not get the 
intended result unless Skeys is already defined to be "softkeys". 

You can examine the current values of all shell variables defined in your 
environment with the command "env". 

2 Positional shell variables, such as $1, $2, and so on, are not supported. Neither 
are special shell variables, such as $@, $*, and so on, supported. 

3 You can continue command file lines. This is done by avoiding the line feed 
with a backslash (\). A line terminated by "\" is concatenated with any 
following lines until a line that does not contain a backslash is found. A line 
constructed in this manner is recognized and executed as one single command 
line. If the last line in a command file is terminated by "\", it appears on the 
command line but is not executed. Normally, the line feed is recognized as the 
command terminator. The UNIX environment recognizes three quoting 
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characters for shell commands which are double quotes ("), single quotes ('), 
and the backslash symbol (\). 

For example, the following three lines are treated as a single shell command. 
The two hidden line feeds are ignored because they are inside the two single 
quotes ('): 

lawk 7$/ { blanks++ } 

END { print blanks } 

' an_unix_file 



To start logging commands to a command file 

• Choose File— >Log— ^Record and use the dialog box to select a command file name. 

• Using the command line, enter the log_commands to <file> command. 



To stop logging commands to a command file 

• Choose File->Log->Stop. 

• Using the command line, enter the log_commands off command. 
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To playback (execute) a command file 

• Choose File— >Log— ^Playback and use the dialog box to select the name of the 
command file you wish to execute. 

• Using the command line, enter the name of the command file and press 
<RETURN>. 

If you enter the name of the command file in the command line and the interface 
cannot find the command file in the current directory, it searches the directories 
specified in the HP64KPATH environment variable. 

To interrupt playback of a command file, press the <CTRL>c key combination. 
(The mouse pointer must be within the interface window.) 

If you press <CTRL>c to stop execution of a command file while the "wait" 
command is being executed from the command file, the <CTRL>c will terminate 
the "wait" command, but will not terminate command file execution. To do this, 
press <CTRL>c again. 
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Using Pod Commands 

Pod commands are Terminal Interface commands. The Terminal Interface is the 
low-level interface that resides in the firmware of the emulator. 

A pod command used in the Graphical User Interface bypasses the interface and 
goes direcdy to the emulator. Because some pod commands can cause the interface 
to become out-of-sync with the emulator, or even cause the interface to terminate 
abnormally, they must be used with care. 

For example, if you change configuration items, the actual state of the emulator will 
no longer match the internal record the interface keeps about the state of the 
emulator. 

Issuing certain communications-related commands can prevent the interface from 
communicating with the emulator and cause abnormal termination of the interface. 

However, it is sometimes necessary to use pod commands. For example, you must 
use a pod command to execute the emulator' s performance verification (pv) 
routine. Performance verification is an internal self-test procedure for the emulator. 

Remember that pod commands can cause trouble for the high-level interface if they 
are used indiscriminately. 

This section shows you how to: 

• Display the pod commands screen. 

• Use pod commands. 
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To display the pod commands screen 

• Choose Display— >Pod Commands. 

The pod commands screen displays the results of pod (Terminal Interface) 
commands. To set the interface to use pod commands, choose Settings— >Pod 
Command Keyboard. 



To use pod commands 

• To begin using pod commands, choose Settings— >Pod Command Keyboard. 

• To end using pod commands, click the suspend pushbutton softkey. 

The Settings— »Pod Command Keyboard command displays the pod commands 
screen and activates the keyboard for entering pod command on the command line. 
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Forwarding Commands to Other HP 64700 
Interfaces 

To allow the emulator/analyzer interface to run concurrently with other HP 64700 
interfaces like the high-level debugger and software performance analyzer, a 
background "daemon" process is necessary to coordinate actions in the interfaces. 

This background process also allows commands to be forwarded from one interface 
to another. Commands are forwarded using the forward command available in the 
command line. The general syntax is: 

forward <interf ace_name> " <command_string> " <RETURN> 

This section shows you how to: 

• Forward commands to the high-level debugger. 

• Forward commands to the software performance analyzer. 



To forward commands to the high-level debugger 

• Enter the forward debug "<command string>" command using the command 
line. 

Examples To send the "Program Run" command to the debugger: 

forward debug "Program Run" <RETURN> 

Or, since only the capitalized key is required: 
forward debug "P R" <RETURN> 
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To forward commands to the software 
performance analyzer 

• Enter the forward perf "<command string>" command using the command line. 



Examples To send the "profile" command to the software performance analyzer: 

forward perf "profile" <RETURN> 
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This chapter describes how to configure the emulator. You must map memory 
whenever you use the emulator. When you plug the emulator into a target system, 
you must configure the emulator so that it operates correctly in the target system. 
The configuration tasks are grouped into the following sections: 

• Using the configuration interface. 

• Modifying the general configuration items. 

• Selecting the emulation monitor program. 

• Mapping emulation and target system memory. 

• Configuring the emulator pod. 

• Setting the debug/trace options. 

The simulated I/O feature and configuration questions are described in the 
Simulated I/O User's Guide. 

The external analyzer configuration questions are described in the "Using the 
External State Analyzer" chapter. 

The interactive measurement configuration questions are described in the "Making 
Coordinated Measurements" chapter. 

Configuring for Operation in the Target System 

After you plug the emulator into a target system and turn on power to the 

HP 64700, you need to configure the emulator so that it operates properly with your 

target system. 

Map memory. Because the emulator can use target system memory or emulation 
memory (or both), it is necessary to map ranges of memory so that the emulator 
knows where to direct its accesses. 

You can synchronize emulation memory accesses to the target system in order to 
more closely imitate target system memory. For example, if emulation memory 
replaces slower target system memory that requires wait states, synchronizing 
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emulation memory to the target system causes wait states to be inserted on 
emulation memory accesses as they would be on target system memory accesses. 

You specify the synchronization of emulation memory by answering a 
configuration question to make the specification for all emulation memory and 
background monitor cycles. 

Select the target system clock as the emulator's clock source. When 

plugging the emulator into a target system, the emulator should use the target 
system clock. 

Set the reset value of the supervisor stack pointer register. Because the 

stack is used when the emulator transitions into the run state, steps, etc., after 
emulation reset, the supervisor stack pointer must point to RAM. 

Set the FRZW bit in the System Control Register (SCR) to avoid 
problems when breaking into the monitor via a watchdog timer RESET. 

The emulator does not set any bits in the SCR. 

Should the emulator operate in 16-bit mode or 8-bit mode? In other 
words, what is the target system data bus width? 

Is there circuitry in the target system that requires programs to run in 
real-time? Some emulator commands cause temporary breaks to the monitor 
program, typically to access microprocessor register values or target system 
memory. If the target system requires that programs run in real-time, you must 
restrict the emulator to real-time runs. 

Should the emulator respond to target system interrupts when 
running programs? If so, you must enable the emulator's response to target 
system interrupts; otherwise, you must disable the emulator's response to target 
system interrupts. 

Should the emulator respond to target system interrupts when 

running in the monitor program? If so, you must use a foreground monitor 
program since target system interrupts are always ignored during background 
operation (refer to the "Selecting the Emulation Monitor Program" section later in 
this chapter). You must also enable the emulator's response to target system 
interrupts. If it's not important that the emulator respond to target system interrupts 
when running in the monitor, you can use the background monitor. 
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Is there circuitry in the target system that constantly monitors bus 
cycle execution (for example, memory refresh circuitry or a watchdog 

timer)? If so, you should drive background cycles to the target system. 
(Foreground monitor cycles appear at the target interface exactly as if they were 
bus cycles caused by a user program.) 

Should bus arbitration be allowed? Generally, the answer to this question 
will be "yes". However, you may disable bus arbitration in order to isolate target 
system problems. For example, if you have a situation where the processor never 
seems to execute any code, you can disable bus arbitration to check and see if 
arbitration circuitry in your target system might be contributing to the problem. 
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Using the Configuration Interface 

This section shows you how to modify, store, and load configurations using the 
emulator configuration interface. 

This section shows you how to: 

• Start the configuration interface. 

• Modify a configuration section. 

• Store a configuration. 

• Change the configuration directory context. 

• Display the configuration context. 

• Access help information. 

• Exit the configuration interface. 

• Load a configuration. 

This chapter describes emulator configuration in general terms. For information 
about your emulator's specific configuration questions, refer to your emulator 
User's Guide. 
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To start the configuration interface 

• Choose Modify— ^Emulator Config... from the emulator/analyzer interface 
pulldown menu. 

• Using the command line, enter the modify configuration command. 

The configuration interface main menu (see example below) is displayed. 

The configuration sections that are presented depend on the hardware and features 
of your particular emulator. 

The configuration interface may be left running while you are using the 
emulator/analyzer interface. 

If you're using the Softkey Interface, you don't get a main menu from which to 
choose configuration sections; however, the same display area and command line 
are used to answer the configuration questions. 
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Examples 



The 68302 emulator configuration interface main menu is shown below. 



Clicking on one of these 
lines selects a particular 
configuration section. 



Clicking this button 
presents the questions 
for the selected 
configuration section. 





I mulatof Configuration: Main Menu 



it 



(-Emulator Configuration Sections - 
^ General Items 
O Monitor Type 
O Memory Map 
^ Emulator Pod Settings 
O Debug/Trace Options 
O Simulated 10 



-Analyzer Configuration Sections 

<> External Analyzer 
\ O Interactive Measurement Specification 



Modify 




Apply to 




Exit 




Help 


Section 




Emulator 




Window 




Topic 



Clicking this button 
stores the current 
configuration. 



Clicking this button 
exits the configuration 
interface. 



Clicking this button 
presents the on-line help. 
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To modify a configuration section 

1 Start the emulator configuration interface. 

2 Click on a section name in the configuration interface main menu, and click the 
"Modify Section" pushbutton. 

3 Use the command line to answer the configuration questions. 

If you're using the Softkey Interface: 

The configuration questions in the "General Items" section are the first to be 
asked. 

To access the questions in the "Monitor Type" section, answer "yes" to the 
"Modify memory configuration?" question. 

To access the questions in the "Memory Map" section, answer "yes" to the 
"Modify memory configuration?" question. 

To access the questions in the "Emulator Pod Settings" section, answer "yes" to 
the "Modify emulator pod configuration?" question. 

To access the questions in the "Debug/Trace Options" section, answer "yes" to 
the "Modify debug/trace options?" question. 
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Each configuration section presents a window similar to the following. 



The menu bar. 



Configuration help *< 
text display area. 



Emulator status 
and error message 
line. 

Command line text 
entry area. 

Pushbutton soTtkeysT 



Command control 
and cursor control 
pushbuttons. 



Emulator Configuration: em68302 (mB8302 



File Display 




When^he internal clock has been selected, the emulator 
[1 operate using an internal oscillator. 

When the external clock has been selected, the emulator 
iui 1 1 operate using the clock driven to the emulator 
from the target system. 

! ote that changing this conf iguration setting will 
drWe the emulator into a reset state. 




Configuring M68302 



Micro-processor clock source? internal 



internal external 



T 



Help 



| RECALL 



Command: Return [Recay Cursor: Backup Forward jCiearto end [Gear Help 




To answer a configuration question, click the softkey pushbutton that has your 
answer. Or, click on the "Return" command pushbutton to accept the answer that is 
shown. 

When you answer a configuration question, you are normally presented with the 
next question in the section; however, there are some cases when a carriage return 
is required, and you can supply it by clicking the "Return" command pushbutton or 
by pressing the <RETURN> key. 
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At the last question of a configuration section, you are asked if you wish to return 
to the main menu. You can click the "next_sec" softkey pushbutton to access the 
questions in the next configuration section. 

To recall a configuration question, click the "RECALL" softkey pushbutton. If you 
do this at the starting question of a configuration section, you are asked if you want 
to return to the main menu. 

In order for the emulator to recognize any configuration changes, the configuration 
must be applied to the emulator. 



To store a configuration 

• When answering the configuration questions, choose File— »Store... from the 
pulldown menu, and use the File Selection dialog box to name the configuration 
file. 

• From the configuration interface main menu, click on the "Apply to Emulator" 
button, and use the File Selection dialog box to name the configuration file. 

• If you're using the Softkey Interface, the last configuration question, 
"Configuration file name?", lets you name the file to which configuration 
information is stored. If you don't enter a name, configuration information is saved 
to a temporary file (which is deleted when you exit the interface and release the 
emulation system). 

The file to which the configuration is stored becomes the current configuration file. 
The emulator only recognizes configuration changes when they are stored or loaded. 

When modifying a configuration using the graphical interface, you can store your 
answers at any time. This is useful for quickly verifying the effect a configuration 
change has on the emulator. 

Configuration information is saved in a file with the extension ".EA". This file is 
the "source", ASCII format copy of the file. (The interface will create a temporary 
file with the extension ".EB" which is the "binary" or loadable copy of the file.) 
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CAUTION Do not modify configurations by editing the ".EA" files. Use the configuration 

interface to modify and save configurations. 



For more information on how to use dialog boxes, refer to the "To use dialog 
boxes" description in the "Using Menus, the Entry Buffer, and Action Keys" 
section of the "Entering Commands" chapter. 



To change the configuration directory context 

• When answering the configuration questions, choose File— ^Directory... from the 
pulldown menu, and use the Directory Selection dialog box to specify the new 
directory. 

The directory context specifies the directory to which configuration files are stored 
and from which they are loaded. 

For more information on how to use dialog boxes, refer to the "To use dialog 
boxes" description in the "Using Menus, the Entry Buffer, and Action Keys" 
section of the "Entering Commands" chapter. 
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To display the configuration context 



• When answering the configuration questions, choose Display— ^Context... from the 
pulldown menu. 



The current directory context and the current configuration files are displayed in a 
window. Click the "Done" pushbutton when you wish to close the window. 



initiator Configuration: Current Conte 



Directory: /users/guest/demo/debug_env/hp64746 
Configuration File: /users/guest/demo/debug_env/hp64746/Config j 




Done 




To access help information 

• When answering the configuration questions, choose Help— ^General Topic... from 
the pulldown menu. 

• From the configuration interface main menu, click on the "Help Topic" button. 
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To exit the configuration interface 

• When answering the configuration questions, choose File— >Exit... from the 
pulldown menu (or type <CTRL>x), and click "Yes" in the confirmation dialog box. 

• From the configuration interface main menu, click the "Exit Window" button, and 
click "Yes" in the confirmation dialog box. 

The confirmation dialog box only appears if changes have been made to the current 
configuration. 

When you choose "Yes" from the confirmation dialog box, any modifications made 
to the configuration which haven't been stored are lost. Choosing "No" from the 
confirmation dialog box cancels the exit and keeps the emulator configuration 
interface running. 



To load a configuration 

• In the emulator/analyzer interface, choose File— >Load— ^Emulator Config... from 
the pulldown menu, and use the File Selection dialog box to specify the 
configuration file to be loaded. 

• Using the command line, enter the load configuration <FILE> command. 
This command loads previously created and stored configuration files. 



107 



Chapter 4: Configuring the Emulator 
Modifying the General Configuration Items 



Modifying the General Configuration Items 

In order to modify the general configuration items, you must first start the 
configuration interface and access the "General Items" configuration section (refer 
to the previous "Using the Configuration Interface" section). 

This section shows you how to: 

• Select the emulator clock source. 

• Enable/disable entry into the monitor after configuration. 

• Restrict to real-time runs. 

• Turn OFF the restriction to real-time runs. 

• Select the inverse assembly syntax for mnemonic displays. 



To select the emulator clock source 

• Answer "external" or "internal" to the "Micro-processor clock source?" question. 

You should always select the external clock option when using the emulator 
in-circuit to synchronize the emulator with your target system. 

Your target system clock must conform to the specifications for the 68302 
microprocessor. The maximum clock speed with the HP 64746 emulator is 
20 MHz. 

When an external clock is selected and the target system power is off, the status line 
will say "Slow clock". 

Note that changing the clock source drives the emulator into the reset state. The 
emulator may later break into the monitor depending on how the "Enter monitor 
after configuration?" question is answered. 

Answering "internal" to the "Micro-processor clock source?" question selects the 
emulator's internal 16 MHz clock oscillator. 
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To enable/disable entry into the monitor after 
configuration 

• Answer "yes" or "no" to the "Enter monitor after configuration?". 

This question allows you to select whether the emulator will be running in the 
monitor or held in the reset state on completion of the emulator configuration. 

The answer to this configuration question is important in some situations. For 
example, when you select the external clock and the target system is turned off, do 
not select reset to monitor. Otherwise, configuration of the emulator will fail. 
When you select an external clock source, this question becomes "Enter monitor 
after configuration (using external clock)?" and the default answer becomes "no". 
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To restrict the emulator to real-time runs 

• Answer "yes" to the "Restrict to real-time runs?" question. 



CAUTION If your target system circuitry is dependent on constant execution of program code, 

you should restrict the emulator to real-time runs. This will help insure that target 
system damage does not occur. However, remember you can still execute the reset, 
break, and step commands; you should use caution in executing these commands. 



The default configuration does not restrict the emulator to real-time runs. 
Therefore, the emulator might make temporary breaks into the monitor to complete 
certain commands. However, you may wish to restrict runs to real-time to prevent 
temporary breaks that might cause target system problems. 

When runs are restricted to real-time and the emulator is running the user program, 
all commands that cause a break (except reset, break, run, and step are refused. 

The following commands are not allowed when runs are restricted to real-time and 
the emulator is running the user program: 

• Display/modify registers. 

• Display /modify target system memory. 

• Load/store target system memory. 

If you want to enter one of these commands, you must first make an explicit break 
into the monitor using the break command. 

Because the emulator contains dual-port emulation memory, commands that access 
emulation memory are allowed while runs are restricted to real-time. 
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To turn OFF the restriction to real-time runs 

• Answer "no" to the "Restrict to real-time runs?" question. 

All commands, regardless of whether or not they require a break to the emulation 
monitor, are accepted by the emulator. 



To select the inverse assembly syntax 

• Answer "64870" or "64845" to the "Inverse assembly syntax to use?" question. 

The HP 64746 emulator accepts absolute files generated by either of 
Hewlett-Packard's software development tool sets. 

• HP 648 19 68000/10 C Cross Compiler 

HP 64845 68000/10 Cross Assembler and Linker 

• HP 64902 68000 C Cross Compiler 

HP 64870 68000/10/20 Assembler/Linker/Librarian 

The assembly language syntax used by the HP 64845 assembler does not use 
Motorola assembly language syntax. For example, you use brackets instead of 
parentheses around address registers and the PC in address register and program 
counter indirect address modes. The HP 64870 assembler uses Motorola syntax. 

This configuration question lets you select which syntax the inverse assembler 
should use in mnemonic memory, trace, and register displays. 
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Selecting the Emulation Monitor Program 

In order to select the type of monitor program used by the emulator, you must first 
start the configuration interface and access the "Monitor Type" configuration 
section (refer to the previous "Using the Configuration Interface" section). 

This section shows you how to: 

• Use the background monitor program. 

• Use a foreground monitor program. 

When you power up the emulator, or when you initialize it, the background monitor 
is used by default. You can also configure the emulator to use a foreground 
monitor. Before the background and foreground monitors are described, you 
should understand the foreground and background emulator modes as well as the 
function of the emulation monitor program. 

The Background Emulator Mode 

Background is the mode in which emulation processor execution does not appear 
normally on the emulator probe. Background cycles may be driven to the target 
system or hidden from the target system. When background cycles are driven, they 
appear as reads. When background cycles are hidden, the emulator appears to the 
target system to be in a suspended state. In background mode, the emulation 
microprocessor executes out of background memory. 

The Foreground Emulator Mode 

Foreground is the mode in which all emulation processor cycles appear on the 
emulation probe, and the emulator executes as if it were a real microprocessor. The 
emulator is in foreground when it executes user programs. In foreground mode, the 
emulation microprocessor typically executes out of target system or emulation 
memory. 

The Function of the Monitor Program 

The monitor program is the interface between the emulation system controller and 
the target system. The emulation system controller uses its own microprocessor to 
accept and execute emulation, system, and analysis commands. The monitor 
program is executed by the emulation microprocessor. 
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The monitor program makes possible emulation commands which access target 
system resources. (The only way to access target system resources is through the 
emulation processor.) For example, when you enter a command to modify target 
system memory, it is the execution of monitor program instructions that cause the 
new values to be written to target system memory. 

When the emulation system controller recognizes that an emulation command 
needs to access target system resources, it writes a command code to a 
communications area and transitions the emulation processor execution into the 
monitor program. The monitor program reads this command (and any associated 
parameters) from the communications area and executes the appropriate 
instructions to access these target system resources. 

The Background Monitor 

On emulator power-up, or after initialization, the emulator uses the background 
monitor program. The background monitor program executes entirely in the 
background emulator mode. The background monitor does not occupy processor 
address space. 

The Foreground Monitor 

You can configure the emulator to use a foreground monitor program. When a 
foreground monitor is selected, it executes in the foreground emulator mode. The 
foreground monitor occupies processor memory space and executes as if it were 
part of the user program. 

When you use a foreground monitor, breaks into the monitor still cause the 
emulator to execute a number of cycles in background. The difference between the 
foreground monitor and the background monitor is that when the background 
monitor is used, all monitor functions are executed in background; when the 
foreground monitor is used, the monitor functions are executed in foreground. 

The foreground monitors are supplied with the interface software and can be found 
in the following path: 

$HP64000/monitor/* 

The monitor program named fmon68302.S should be assembled and linked with 
the HP 64845 68000/10 Cross Assembler/Linker, and the monitor named 
Mfmon68302.s should be assembled and linked with the HP 64870 assembler. 

You may customize the foreground monitor if necessary; however, you must 
maintain the basic communications protocol between the monitor and the emulation 



113 



Chapter 4: Configuring the Emulator 
Selecting the Emulation Monitor Program 



system controller. Comments in the monitor program source file detail sections 
that cannot be changed. 



Comparison of Background and Foreground Monitor Programs 


Monitor Program Characteristic 


Background 


Foreground 


Takes up processor memory space 


No 


Yes 


Allows the emulator to respond to target system 
interrupts during monitor execution 


No 


Yes 


Can be customized 


No 


Yes 


Can be used when performing coordinated measurements 
with other emulators 


Yes 


No 


Resident in emulator firmware 


Yes 


No, must be 
assembled and linked 
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To use the background monitor program 

1 Answer "background" to the "Monitor type?" question. 

2 Answer "yes" to the "Reset map (change of monitor type requires map reset)?" 
question. 

3 Re-map memory (see the following section on "Mapping Memory"). 

When you select the background monitor program, a memory overlay is created 
and the background monitor is loaded into that area. 

Changing the monitor configuration resets the memory map, so you must re-map 
memory. 

You can use the emulator pod configuration questions listed below to specify how 
the emulator will drive the target system during background monitor execution. 

• "Drive background cycles to target system?" 

• "Value for address bits A23-A16 during background cycles?" 

• "Function code for background cycles?" 

The 68 302 e mulator's background monitor disables target system interrupts; also, it 
asserts FRZ. 

To look at the 68302' s internal memory space when using a background monitor, it 
must be mapped as target RAM. 

When stepping through program execution and an interrupt occurs while the 
emulator is executing in background, another step command looks as though it 
causes the same instruction to execute. Actually, the instruction does not execute 
because the interrupt occurs before the instruction is executed. 
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To use a foreground monitor program 

1 Edit the monitor program source file to define its base address. 

2 Assemble and link the monitor program. 

3 Start the configuration interface and access the "Monitor Type" section. 

4 Answer "foreground" to the "Monitor type?" question. 

5 Answer "yes" to the "Reset map (change of monitor type requires map reset)?" 
question. 

6 Enter the base address of the monitor in response to the "Monitor address?" 
question. 

7 Answer "none" or "supervisor" to the "Monitor function code?" question. 

8 Enter the name of the monitor program absolute file in response to the "Monitor 
filename?" question. 

9 Re-map memory (see the following section on "Mapping Memory"). 

10 Modify the TRACE exception vector to point to the TRACE_ENTRY symbol in 
the monitor program so that you can step through the user program. 

The foreground monitor program's base address should be on any 2 Kbyte 
boundary (address ending in 000H or 800H) except OH (since that's the location of 
the vector table). If you are using the HP 64170 memory board with 1 Mbyte 
memory modules, the base address should be on an 8 Kbyte boundary. An ORG 
statement in the foreground monitor source file defines the base address. Also, the 
base address is specified when configuring the emulator to use a foreground 
monitor program. 

When you select a foreground monitor, a block of emulation memory is 
automatically mapped with the function code specified. 
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The monitor program absolute file will be loaded after you have answered all the 
configuration questions. Only the memory reserved for the monitor is loaded after 
configuration. Therefore, you should not link the foreground monitor to the user 
program. If the symbol database must contain both monitor and user program 
symbols, create a different absolute file linking the monitor and user program. You 
load this file after configuration. 

Because the shipped foreground monitor writes to vector table locations (the IPA 
bit in the SCR register is cleared), you must either answer "no" the "Break 
processor on write to ROM?" debug/trace configuration question or you must map 
the vector table locations as RAM. Otherwise, a break to the monitor causes a 
break on write to ROM which causes a break to the monitor, and so on. 

In order to step through programs when using a foreground monitor, you must 
modify the TRACE vector (24H) in the processor's exception vector table. The 
TRACE exception vector must point to the TRACE_ENTRY label in the 
foreground monitor program. 



Examples The following examples of how to set up and use a foreground monitor program 

assume the HP 64870 or HP B 1464 68000/08/10/20/302 
Assembler/Linker/Librarian is installed on the host computer. 

To copy the foreground monitor program source file: 

S cp $HP64000/monitor/Mfmon68302 . s . <RETURN> 

To edit the monitor program source: 

$ chmod 644 Mfmon68302 . s <RETURN> 
$ vi Mfmon68302.s <RETURN> 

The monitor will be loaded at 10000H, so the modify ORG statement near the top 
of the file to look like this: 

ORG 010000H * START MONITOR ON 2K BOUNDARY OTHER THAN ZERO 

Notice that the ORG statement is indented from the left margin; if it is not indented, 
the assembler will interpret the ORG as a label and will generate an error when 
processing the address portion of the statement. 
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To assemble and link the monitor program, enter the following commands (which 
assume that $HP64000/bin is defined in the PATH environment variable): 

S as68k -hL Mfmon68302.s > Mfmon68302 . lis <RETURN> 

$ ld68k -he Mfmon68302.k -L > Mfmon68302 .map <RETURN> 

Where the "Mfmon68302.k" linker command file is: 

name Mfmon68302 
load Mfmon68302 . o 
end 

To configure the emulator to use a foreground monitor program, access the 
configuration questions, and answer the questions as shown below. 

Inverse assembly syntax to use? 64870 
Modify memory configuration? yes 
Monitor type? foreground 

Reset map (change of monitor type requires map reset)? yes 

Monitor address? lOOOOh 

Monitor file name? Mfmon68302.X 

Re-map memory for the emulator demo program by entering the following mapper 
commands: 

0 thru Offffh emulation ram <RETURN> 
80000h thru 87fffh emulation ram <RETURN> 
OfffOOOh thru Offffffh target ram <RETURN> 
end <RETURN> 

Configuration file name? fmoncfg 

To load the demo program absolute file, enter the following command using the 
command line: 

load ecs <RETURN> 
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To modify the TRACE exception vector to point to the TRACE_ENTRY label in 
the monitor program (so that the emulator can single-step), enter the following 
commands using the command line: 

load symbols Mfmon68302 <RETURN> 

modify memory 24h long to Mfmon68302 . s : TRACE_ENTRY 
<RETURN> 

load symbols ecs <RETURN> 
Now, you are ready to use the emulator. 
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Mapping Memory 

Because the emulator can use target system memory or emulation memory (or 
both), it is necessary to map ranges of memory so that the emulator knows where to 
direct its accesses. 

When mapping memory, there a couple terms that you should be familiar with: 

Mapper ranges — the maximum number of address ranges that can be 
mapped. 

Resolution — the minimum size address range that can be mapped. 

Block size — the smallest amount of emulation memory that can be allocated 
by the mapper. 



The following table summarizes these parameters for the various emulators and 
emulation memory configurations. 



Emulation Memory Configurations 


Emulator, Amount of memory 


Mapper 
ranges 


Block size 


Resolution 


Foreground 

monitor 
block size 1 


HP 64746, 128 Kbytes 


7 


1 Kbyte 


1 Kbyte 


2 Kbytes 


HP 64746, 512 Kbytes 


7 


1 Kbyte 


1 Kbyte 


2 Kbytes 


HP 64746 w/HP 64170 and HP 64171A 
memory modules (256 Kbytes each) 


7 


2 Kbytes 


256 bytes 


2 Kbytes 


HP 64746 w/HP 64170 and HP 64171B 
memory modules (1 Mbyte each) 


7 


8 Kbytes 


1 Kbyte 


8 Kbytes 


lr This also the boundary on which the monitor's base address must be located. 



Notice the resolution can be smaller than the block size. In this case, it's possible 
for emulation memory to be wasted. For example, suppose the resolution is 256 
bytes and the block size is 2 Kbytes; if you map an emulation memory range that is 
2304 bytes long (2 Kbytes + 256 bytes), the mapper will allocate 4 Kbytes of 
emulation memory, 1792 bytes (2 Kbytes - 256 bytes) of which are unused. 
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Direct memory access (DMA) to emulation memory is not permitted. 

You should map all memory ranges used by your programs before loading 
programs into memory. 

Note that the internal memory space of the 68302 must be mapped as target RAM. 
The BAR and SCR registers (located at 0F0H and 0F4H in the exception vector 
table) may be mapped as emulation RAM, but you should use the register (not 
memory) command to modify or examine these locations. 

In order to map memory, you must first start the configuration interface and access 
the "Memory Map" configuration section (refer to the previous "Using the 
Configuration Interface" section). 



To map memory ranges 

• Enter the address range and memory type for emulation memory ranges. 

You can characterize memory ranges as emulation RAM, emulation ROM, target 
system RAM, target system ROM, or as guarded memory. 

Guarded memory accesses will cause emulator execution to break into the monitor 
program. 

Writes to locations characterized as ROM will cause emulator execution to break 
into the monitor program if the "Break processor on write to ROM?" trace/debug 
configuration option is enabled. 

Writes to emulation ROM will be inhibited. Writes by user code to target system 
memory locations mapped as ROM or guarded memory will result in a break to the 
monitor but are not inhibited (that is, the write still occurs). 
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Examples Consider the following section summary from the linker load map output listing. 

SECTION SUMMARY 



SECTION 


ATTRIBUTE 


START 


END 


LENGTH 


ALIGN 




ABSOLUTE DATA 


00000000 


0000002F 


00000030 


0 


(BYTE) 


0 


NORMAL 




00000030 


00000030 


00000000 


2 


(WORD) 


env 


NORMAL 


CODE 


00002000 


00002BC6 


00000BC7 


2 


(WORD) 


prog 


NORMAL 


CODE 


00002BC8 


000036D9 


00000B12 


2 


(WORD) 


const 


NORMAL 


ROM 


000036DA 


0000371F 


00000046 


2 


(WORD) 


lib 


NORMAL 


CODE 


00003720 


00004521 


00000E02 


2 


(WORD) 


envdata 


NORMAL 


DATA 


00005000 


00005157 


00000158 


4 


(LONG) 


libc 


NORMAL 


CODE 


00005158 


0000744F 


000022F8 


2 


(WORD) 


libm 






00007450 


00007450 


00000000 


0 


(BYTE) 


mon 


NORMAL 


CODE 


00007450 


00007599 


0000014A 


2 


(WORD) 


data 


NORMAL 


DATA 


0000759A 


00007B65 


000005CC 


2 


(WORD) 


idata 






00007B66 


00007B66 


00000000 


0 


(BYTE) 


udata 






00007B66 


00007B66 


00000000 


0 


(BYTE) 


markers 






00007B66 


00007B66 


00000000 


0 


(BYTE) 


libdata 


NORMAL 


DATA 


00007B68 


00007B6B 


00000004 


4 


(LONG) 


libcdata 


NORMAL 


DATA 


00007B6C 


00008597 


00000A2C 


2 


(WORD) 


mondata 


NORMAL 


DATA 


00008598 


000085BB 


00000024 


2 


(WORD) 


stack 


NORMAL 


DATA 


00009000 


0000CFFF 


00004000 


4 


(LONG) 


heap 


NORMAL 


DATA 


0000D000 


0000FFFD 


00002FFE 


4 


(LONG) 



Notice the ABSOLUTE DATA section occupies 0 through 30H. These are vector 
table locations, and because the BAR and SCR registers (located at 0F0H and 
0F4H) are also in the vector table, this area should be mapped as emulation RAM. 

Notice the NORMAL CODE and ROM sections occupy locations 2000H through 
452 1H. Because the contents of these sections will eventually reside in target 
system ROM, this area should be characterized as ROM when mapped. This will 
prevent these locations from being written over accidentally. If breaks on writes to 
ROM are enabled, instructions that attempt to write to these locations will cause 
emulator execution to break into the monitor. 

Also, notice that other CODE and DATA sections occupy locations 5000H through 
0FFFFH. Since these sections are written to, they should be characterized as RAM 
when mapped. 

Finally, the internal memory space must be mapped as target RAM. Assuming the 
reset value of the BAR register is used, the range 0FFF000H through 0FFFFFFH 
should be mapped as target RAM. 



122 



Chapter 4: Configuring the Emulator 
Mapping Memory 

Enter the following commands to map memory for the above program. 

delete all <RETURN> 

0 thru 3ffh emulation ram <RETURN> 

2000h thru 4fffh emulation rom <RETURN> 

5000h thru Offffh emulation ram <RETURN> 

OfffOOOh thru Offffffh target ram <RETURN> 



The resulting memory mapper screen is shown below. 



Emulation memory blocks: available - 


mapped - ^^^3 " bytes 


|entry range *yp e function 




1 0H- 3FFH EMUL/RRM 




2 2000H- 4FFFH EMUL/ROM 




3 5000H- FFFFH EMUL/RRM 




4 FFF000H- FFFFFFH TflRGET/RRM 





To exit out of the memory mapper, enter: 
end <RETURN> 



To characterize unmapped ranges 

• Use the default softkey to characterize unmapped ranges. 

The default softkey in the memory mapper allows you to characterize unmapped 
memory ranges. Unmapped memory ranges are treated as target system RAM by 
default. Unmapped memory ranges cannot be characterized as emulation memory 

Examples To characterize unmapped ranges as target RAM: 

default target ram <RETURN> 

To characterize unmapped ranges as guarded memory: 
default guarded <RETURN> 
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To exit out of the memory mapper, enter: 
end <RETURN> 



To delete memory map ranges 

• Use the delete softkey to delete mapped ranges. 

Note that programs should be reloaded after deleting mapper terms. The memory 
mapper may re-assign blocks of emulation memory after the insertion or deletion of 
mapper terms. 



Examples To delete term 1 in the memory map: 

delete 1 <RETURN> 

To delete all map terms: 
delete all <RETURN> 

To exit out of the memory mapper, enter: 
end <RETURN> 
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To map memory ranges that use function codes 

• Specify function codes with address ranges when mapping memory. 

Function code information lets you further characterize memory blocks as 
supervisor, user, supervisor program, supervisor data, user program, or user data 
space. When you specify function codes with mapper ranges, the 68302 function 
code outputs (FCO, FC1, FC2) are decoded to select particular blocks of memory. 
Function codes let you overlay address ranges. When you specify function codes 
as part of the address, the emulator memory mapper knows that overlaid blocks are 
different memory regions and will define them separately. 

If you specify a function code when mapping a range of memory, you must include 
the function code when referring to locations in that range. If you don't include the 
function code, an "ambiguous address" error message is displayed. 

If you use different function codes, it's possible to map address ranges that overlap. 
When address ranges with different function codes overlap, you must load a 
separately linked module for the space associated with each function code. The 
modules are linked separately because linker errors occur when address ranges 
overlap. 

When address ranges are mapped with different function codes, and there are no 
overlapping ranges, your program modules may exist in one absolute file. 
However, you have to use multiple load commands — one for each function code 
specifier. This is necessary to load the various sections of the absolute file into the 
appropriate function code qualified memory ranges. When you do this, be sure that 
all address ranges not mapped (that is, the "other" memory mapper term) are 
mapped as target RAM. When "other" is mapped as guarded, guarded memory 
access errors (from the attempt to load the absolute file sections that are outside the 
specified function code range) can prevent the absolute file sections that are inside 
the specified function range from being loaded. 
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Examples Suppose you're developing a system with the following characteristics: 

• Output port at 400 hex. 

• Supervisor program from 1000 through lfff hex. 

• Supervisor data from 2000 through 2fff hex. 

• User program from 3000 through 3fff hex. 

• User data from 3000 through 3fff hex. 

Notice that the last two terms have address ranges that overlap. You can use 
function codes to cause these terms to be mapped to different blocks of memory. 

Suppose also that the only things that exist in your target system at this time are the 
input and output ports and some control logic; no memory is available. You can 
reflect this by mapping the I/O ports to target system memory space and the rest of 
memory to emulation memory space with the following mapper commands: 

Oh thru Offfh target ram <RETURN> 

lOOOh thru lfffh supervisor program emulation rom 

<RETURN> 

2000h thru 2fffh supervisor data emulation ram <RETURN> 
3000h thru 3fffh user program emulation ram <RETURN> 
3000h thru 3fffh user data emulation ram <RETURN> 



After the configuration is saved, display memory at 1000H by entering the 
following command (using the command line): 

display memory lOOOh blocked bytes <RETURN> 



Notice that an "ambiguous address" error occurs because the "sp" function code 
was not included with the address. The following command should have been 
entered instead: 

display memory fcode sp lOOOh blocked bytes <RETURN> 
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Configuring the Emulator Pod 

In order to configure the emulator pod, you must first start the configuration 
interface and access the "Emulator Pod Settings" configuration section (refer to the 
previous "Using the Configuration Interface" section). 

This section shows you how to: 

• Enable/disable bus arbitration. 

• Specify the analyzer' s response to bus arbitration. 

• Enable/disable emulation memory synchronization. 

• Enable/disable /BERR connection to target system. 

• Enable/disable response to target system interrupts. 

• Select the normal or dedicated interrupt mode. 

• Set the reset value of the Supervisor Stack Pointer. 

• Set the processor data bus width. 

• Set the target system memory access size. 

• Select /IACK7 or PBO. 

• Drive background cycles to the target system. 

• Stop driving background cycles to the target system. 

• Specify /DTACK sources for chip selects. 
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To enable/disable bus arbitration 

• Answer "yes" to the "Enable bus arbitration?" question to enable target system bus 
arbitration; answer "no" to disable the target bus arbitration. 

Enabling and disabling bus master arbitration can be useful for isolating target 
system problems. For example, you may have a situation where the processor 
never seems to execute any code. You can disable bus arbitration to see if faulty 
arbitration circuitry in your target system is contributing to the problem. 

When bus arbitration is enabled: 

The emulator responds to the /BR (bus request) and /BGACK (bus grant 
acknowledge) signals from the target system just like the microprocessor. 

The emulator does not support DMA (direct memory access) to emulation 
memory. Internal 68302 DMA can happen regardless of the answer to this 
question. The /BGACK signal will always be active on internal DMA 
operations. 

When bus arbitration is disabled: 

The emulator ignores the /BR and /BGACK signals from the target system. 
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To specify the analyzer's response to bus 
arbitration 

• Answer "disable", "enable", or "tag" to the "Arbitration analysis?" question. 

When DMA tracing is disabled, the analyzer will not capture any external or 
internal DMA, bus cycles. 

When DMA tracing is enabled, the analyzer will capture analyzer states during 
external or internal DMA bus cycles. The analyzer state can be generated only if 
the processor strobes are actually being driven on the external DMA cycle. 

When DMA tagging is enabled, a single emulation analyzer state will be generated 
each time an external bus arbitration sequence occurs. Processor strobes do not 
need to be driven. 
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To enable/disable emulation memory 
synchronization 

• Answer "yes" to the "Interlock emulator /DTACK with user /DTACK?" question to 
enable synchronization; answer "no" to disable synchronization. 

/DTACK interlock applies only to situations where the 68302 does not provide an 
internal /DTACK. The 68302 processor can generate internal /DTACK signals for 
chip selects or internal processor cycles. (The source of the emulator /DTACK for 
chip selects is specified by answering the "/DTACK source for chip select" 
configuration questions.) If the /DTACK is internally generated, it will be driven 
to the target system, and the emulator will not drive /DTACK to the processor. 

Also, /DTACK interlock applies only when you are operating the emulator 
in-circuit (that is, plugged into a target system). If you are operating the emulator 
out-of-circuit, all emulation and background monitor accesses are completed by the 
emulator-generated /DTACK signal, regardless of the answer to this configuration 
question. 

When /DTACK interlock is enabled: 

Accesses to emulation memory will not be terminated until the target system 
provides a /DTACK. 

If background cycles are being driven to the target system (see the following 
"Drive background cycles to the target system?" question), the target system 
must provide a /DTACK signal to terminate background memory cycles. 

If a /BERR signal occurs during an emulation memory cycle when bus error 
response is enabled (see the following "Enable Bus Error on emulation 
memory accesses?" question), the cycle will be terminated, and the emulation 
processor will begin executing the bus error handler. 

When /DTACK interlock is disabled: 

Emulation memory and background monitor accesses are terminated with a 
/DTACK signal generated by the emulator. 
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To enable/disable /BERR connection to target 
system 

• Answer "yes" or "no" to the "Enable Bus Error connected to target system?" 
question. 

The emulator will always respond to the /BERR signal during target system 
memory cycles. 

When /BERR connection to the target system is enabled: 

The target system /BERR and emulation system /BERR signals are tied 
together. If your target system asserts the /BERR signal during emulation 
memory cycles, the emulation processor terminates the cycle and begins 
executing your bus error handler. 

Note that the emulation system /DTACK must be interlocked with the target 
system /DTACK in order for the emulator to respond correctly to the /BERR 
signal from the target system. 

When /BERR connection to the target system is disabled: 

The target system /BERR and emulation system /BERR signals are 
disconnected. The emulation 68302 can still generate /BERR; however, the 
target system will not see this signal. Likewise, the emulator will not respond 
to target system bus errors. 
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To enable/disable response to target system 
interrupts 

• Answer "yes" to the "Respond to target system interrupts?" question to enable the 
emulator's response; answer "no" to disable the emulator's response. 

When enabled, the emulator responds to target system interrupts during foreground 
operation. Target system interrupts are always ignored during background 
operation. 

All 68302 systems require a vector table to process system conditions such as 
divide by zero or trace traps. You need to provide such a vector table to manage 
these conditions. Exception processing attempted without a vector table will cause 
unpredictable behavior. 



To select the normal or dedicated interrupt mode 

1 Answer "normal" or "dedicated" to the "Interrupt Mode?" question. 

2 If you select the dedicated interrupt mode, answer "yes" or "no" to the 7IRQ7 
mode = level?" question to specify whether interrupt 7 should be level or edge 
sensitive. 

In normal mode, the interrupt inputs to the processor are encoded on IPL2, IPL1, 
and IPLO. 

In dedicated mode, IPL2 becomes IRQ7, IPL1 becomes IRQ6, and IPLO becomes 
IRQ1. 



Note It is important to answer these questions so that they match what is programmed 

into the GIMR register. 
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To set the reset value for the Supervisor Stack 
Pointer 

• Enter an even address in response to the "Reset value of Supervisor Stack Pointer?" 
question. 

In order for the emulator to transition into the run state, to step, or to perform other 
functions after emulation reset, the supervisor stack pointer must be set to an 
appropriate value. 

The value specified must be a 32-bit hexadecimal even address. This address 
should reside in an otherwise unused emulation or target system RAM area. 

Upon the first transition from emulation reset into the emulation monitor, the 
supervisor stack pointer register is set to the value specified. 

Note that a target system reset that occurs during background monitor operation 
will not affect the supervisor stack pointer value. 

Note that when you use a foreground monitor, the reset value of the supervisor 
stack pointer must be at least six bytes away from a guarded memory area. If the 
reset value of SSP is not six bytes away from a guarded area, a "Stack is in guarded 
memory" error will occur when you attempt to run the program. 
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To set the processor data bus width 

• Answer "yes" to the "Data bus width 16 bits?" question to set 16-bit mode; answer 
"no" to set 8-bit mode. 

The data bus width setting only applies when operating the emulator out-of -circuit 
(that is, not connected to the target system). When in circuit, the target system 
BUSW pin overrides the answer to this configuration question. 

When an 8-bit data bus width is specified, target memory is always accessed as 
bytes, and the "Target memory access size?" configuration question is not asked. 



To specify the target memory access size 

• Answer the "Target memory access size?" question. 

The target memory access size only applies when a 16-bit data bus width is selected 
(either by the previous "Data bus width 16 bits?" configuration question when 
out-of-circuit or by the BUSW pin when in-circuit). 

When accessing target system memory locations, the access mode specifies the type 
of microprocessor cycles that are used to read or write the value(s). For example, 
when the access mode is byte and a target system location is modified to contain 
the value 12345678H, byte instructions are used to write the byte values 12H, 34H, 
56H, and 78H to target system memory. 

Answer "bytes" if the emulator should make 8-bit accesses to target system 
memory. 

Answer "words" if the emulator should make 16-bit accesses to target system 
memory. 
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To select /IACK7 or PBO 

• Answer 7IACK7" or "PBO" to the "/IACK7 pin is" question. 

When the /IACK7-PB0 pin is used as an interrupt acknowledge line, the emulator 
blocks emulator-generated level 7 interrupt acknowledges to the target system. 

When the /IACK7-PB0 pin is used as a port B peripheral pin, the emulator does not 
affect the PBO line. 



To drive background cycles to the target system 

1 Answer "yes" to the "Drive background cycles to the target system?" question. 

2 Select the A23-A16 values for driven background cycles by entering a hexadecimal 
byte value in response to the "Value for address bits A23-A16 during background 
cycles?" question. 

3 Select the function code for driven background cycles by responding to the 
"Function code for background cycles?" question. 

These questions are only asked when you are using a background monitor. 

When background cycles are driven to the target system, all of the emulation 
processor's address, data and control strobes are driven. Writes to background 
memory will appear as reads to the target system. 

When specifying a value for the upper address bits, you should choose an address 
block which will not interfere with your target system circuitry such as memory 
management units or cache memory. 
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The function code specified can be: 
supr prog (FC2-FC0=1 10) 

supr data (FC2-FC0=101) 

user prog (FC2-FC0=010) 

user data (FC2-FC0=001) 

Choose a function code that will not cause target system hardware such as memory 
management units to behave in an unpredictable manner. 



To stop driving background cycles to the target 
system 

• Answer "no" to the "Drive background cycles to the target system?" question. 

The emulator will appear to the target system as if it is between bus cycles while it 
is operating in the background monitor. 
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To specify /DTACK sources for chip selects 

• Answer "internal" or "external" to the "/DTACK source for csO? (csl?, cs2?, cs3?)" 
questions. 

The 68302 chip selects can be configured either to generate the /DTACK signal 
internally or to use an externally supplied /DTACK. The emulator looks at two 
things to decide which source of the /DTACK it should look for when a given chip 
select is active: 

• The chip select lines (programmed using registers BR0-BR3). The source of 
/DTACK for the chip select lines is determined by the corresponding /DTACK 
field bits (programmed using OR0-OR3). The order in which you write these 
registers is significant. 

Registers OR0-OR3 contain, among other things, a base address mask field. 
The base address mask is used to set the block size of the corresponding chip 
select line. The emulator assumes that this register will be programmed to map 
one contiguous block for the chip select line. The 68302 processor does not 
enforce this rule, so you should be careful not to map several ranges for a 
specific chip select. 

• The /DTACK source configuration. 

Be sure that the emulator configuration and the configuration of the chip select 
lines are consistent. 

When "internal" is selected, an active signal on the associated chip select causes the 
/DTACK signal to be driven to the target system. The emulator will not drive 
/DTACK to the processor on these cycles. 

When "external" is selected, an active signal on the associated chip select causes 
the /DTACK signal to be driven to the processor. The source of this /DTACK 
signal is either the emulator or the target system as determined by the /DTACK 
interlock configuration question and the memory map. 
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Setting the Debug/Trace Options 

In order to set the debug/trace options, you must first start the configuration 
interface and access the "Debug/Trace Options" configuration section (refer to the 
previous "Using the Configuration Interface" section). 

This section shows you how to: 

• Enable/disable breaks on writes to ROM. 

• Specify which TRAP instruction is used for software breakpoints. 

• Include/exclude background states in the trace. 



To enable/disable breaks on writes to ROM 

• Answer "yes" to the "Break processor on write to ROM?" question to enable 
breaks; answer "no" to disable breaks. 

When breaks on writes to ROM are enabled: 

The emulator will break into the emulation monitor whenever the user program 
attempts to write to a memory region mapped as ROM. 

The emulator will prevent the processor from actually writing to memory 
mapped as emulation ROM; however, it cannot prevent writes to target system 
RAM locations which are mapped as ROM, even though the write to ROM 
break is enabled. 

When breaks on writes to ROM are disabled: 

The emulator will not break to the monitor upon a write to ROM. 

The emulator will not modify the memory location if it is in emulation ROM. 
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To specify which TRAP instruction is used for 
software breakpoints 

• Enter a value in response to the "Trap number for software breakpoint (0..0FH)?" 
question. 

You can answer with values from 0 through OFH to specify the particular TRAP 
instruction used for software breakpoints. The value indicates the exception vector 
to use in processing the trap. 

Use this configuration option if you have inserted other TRAP instructions in your 
code with varying exception vector values. The configuration option allows you to 
specify a different exception vector than the ones previously inserted. The 
emulation monitor then responds normally to execution of a breakpoint. 

When you change the answer to this configuration question, any software 
breakpoints currently defined are disabled. (The software breakpoint trap 
instructions currently in memory would be different than the new value you have 
specified.) 

Note that any breakpoints defined in target memory must be cleared (by the 
software breakpoints command) before the TRAP instruction is changed. 
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To include/exclude background states in the trace 

• Answer "background" or "both" to the "Trace background or foreground 

operation?" question to include background states in the trace; answer "foreground" 
to exclude background states from the trace. 

Answering "background" specifies that the analyzer trace only background cycles. 
This is rarely a useful setting for user program debugging. 

Answering "both" specifies that the analyzer trace both foreground and background 
cycles. You may wish to specify this option so that all emulation processor cycles 
may be viewed in the trace display. 

Answering "foreground" specifies that the analyzer trace only foreground cycles. 
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This chapter contains information about plugging the emulator into target systems 
and configuring the emulator so that it operates correctly. 

• Connecting the Emulator Probe 

• Configuring the Emulator for In-Circuit Operation 
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Connecting the Emulator Probe 

The 68302 emulator probe plugs into a PGA through-hole socket that is soldered 
into the target system. 

This section describes the steps you must perform when connecting the emulator to 
a target system: 

1 Turn OFF power. 

2 Plug the emulator probe into the target system. 

3 Turn ON power. 

Also, this section provides information about probing a target system designed for a 
PQFP package microprocessor. 



CAUTION Possible Damage to the Emulator Probe. The emulator contains devices that are 

susceptible to damage by static discharge. Therefore, precautionary measures 
should be taken before handling the emulator probe to avoid damaging the internal 
components of the emulator by static electricity. 
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Step 1 . Turn OFF power 



CAUTION Possible Damage to the Emulator. Make sure target system power is OFF and 

make sure HP 64700 power is OFF before removing or installing the emulator 
probe into the target system. 

Do not turn HP 64700 power OFF while the emulator is plugged into a target 
system whose power is ON. 



1 If the emulator is currently plugged into a different target system, turn that target system's power OFF. 



2 Turn emulator power OFF. 
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Step 2. Connect the probe to the target system 



CAUTION Possible Damage to the Emulator Probe. A pin extender is included with the 

emulator probe. Do not use the probe without a pin extender (that is, an extra 
PGA socket) installed. Replacing a broken pin extender is much less expensive 
than replacing the emulator probe adapter. 

The use of more than one pin extender is discouraged, unless it is necessary for 
mechanical clearance reasons, because pin extenders cause signal quality 
degradation. 

PGA sockets are available from HP as HP part number 1200-13 18. A MacKenzie 
Technology PGA- 1 00M-003B 1 - 1 324 socket should also be suitable. 
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1 Install the emulator probe into the target system socket. Be sure to orient the probe correctly. Pin Al 
of the PGA matrix is at the notched corner of the probe. (Note that pin "Al " of the PGA matrix is signal 
"A14." Pin numbers do not correspond to signal numbers for the 68302.) Damage to the emulator will 
result if the probe is incorrectly installed. 




CAUTION: MAKE SURE PIN A1 OF THE PROBE CONNECTOR IS 
ALIGNED WITH PIN A1 OF THE SOCKET 
DAMAGE TO THE EMULATOR PROBE WILL RESULT IF 
THE PROBE IS INCORRECTLY N5T ALLED 
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Step 3. Turn ON power 



1 Turn emulator power ON. 



2 Turn target system power ON. 
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If you need a PQFP connector 

If your target system uses the MC68302FE surface mount (PQFP) package, you 
should order the following parts: 

• HP A24 1 4 QFP Probe Adapter Assembly 

• Motorola MC22901PQFP132 dummy part 

The "dummy" part should be installed in place of the microprocessor on your target 
system. The QFP Probe Adapter Assembly connects the dummy part to the 
emulator's PGA probe. 
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Configuring the Emulator for In-Circuit Operation 

Many users of the 68302 emulator encounter problems when first plugging the 
emulator into their target system. This section should help you avoid or quickly 
correct most of those problems. 

• Step 1 . Understand the important concepts 

• Step 2. Set up your chip-selects 

• Step 3. Reprogram chip-select base addresses 

• Step 4. Know your interrupt mode 

• Step 5 . Decide whether to use the foreground monitor 

• Step 6. Set up the emulator for the foreground monitor 

• Step 7 . If you use the 68302 built-in DRAM refresh 

• Step 8 . Set up the DTACK signals 

• Step 9. If emulator status shows HALTED 

• Step 10. Choose the correct target memory access size 

• Step 1 1 . Check your DTACK pullup resistor ! 

• If you have problems 
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Step 1 . Understand the important concepts 

There are a few basic concepts related to 68302 emulation that should be 
understood before you begin. Understanding these concepts will help you avoid 
the common startup problems. 

Accessing Memory that is Enabled via a Chip Select 

Nearly all 68302 target systems rely on the built-in chip-selects for at least some 
accesses to memory. The important concept to remember is that the 68302 
emulator does not automatically setup any chip-selects for you other than 
chip-select zero, which is automatically setup by the 68302 itself. 

If you attempt to access memory that is dependent on a chip-select being 
programmed, without first ensuring that that chip-select is programmed, some type 
of failure will result. This most often causes problems when you are trying to do 
commands such as load memory, display memory, run, or step. 

Setting the Interrupt Mode to Dedicated or Normal 

The 68302 has two basic types of external interrupts, referred to as Normal or 
Dedicated mode. In Normal mode, three lines are used to indicate interrupt levels 0 
through 7 or no interrupt. This normal mode scheme is just like the one used on 
traditional 680X0 devices. In dedicated mode, the three lines each have a dedicated 
purpose, one for each of the interrupts level 1, 6 and 7. 

Why is this important? The emulator uses a level 7 interrupt to accomplish what is 
known as a "break" from the user program to the emulation monitor program. The 
monitor is needed for tasks such as display /modify of target memory and 68302 
registers, as well as single-stepping. In order to initiate a level 7 interrupt, the 
emulator must know what interrupt mode the 68302 has been programmed for. An 
emulator configuration question is used to indicate which mode the 68302 will be 
in. If the 68302 is not in that mode when a break is attempted, the break will either 
fail, or lead to unexpected interrupts. 

Note that although the 68302 emulator uses the level 7 interrupt, you are free to use 
the level 7 interrupt for your own purposes. This is because the emulator is able to 
differentiate between a target system-generated interrupt and and an 
emulator-generated interrupt. 
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The Freeze Pin and the Background Monitor 

The 68302 has a hardware input pin called FRZ which can be used to "freeze" 
selected on-chip peripherals. When configured for the background monitor, the 
68302 emulator will assert the FRZ pin during the entire time the emulator is 
running in the monitor. 

If you are using the SCC functions of the 68302 or the built-in DRAM refresh 
feature you will most likely want to configure your emulator for use with the 
foreground monitor since these functions will be "frozen" during all background 
monitor operation. "Step 5. Decide whether to use the foreground monitor" will 
further explain these issues. 

While running in the background monitor the watchdog timer will not be serviced. 
However, knowing that the FRZ pin is asserted during background monitor 
operation makes it easy for you to freeze the watchdog timer during this time. 
Freezing the watchdog timer will be discussed later. 

On-Chip Locations 

Most of the special features of the 68302 are controlled via a 4 Kbyte block of 
on-chip locations (RAM and special registers). The address of that 4 Kbyte block 
is determined by the value written to the BAR. When you configure the emulator 
you must map that 4 Kbyte block of memory as target RAM. Mapping that block 
as "guarded" or "emulation" memory will prevent proper operation or result in 
guarded memory access errors. 

Any display or modify of on-chip locations, including registers, requires the 
emulation monitor program. If you do a display or modify of these locations or 
registers while running your program, the emulator will briefly break into the 
monitor, perform the display or modify, then return to your program. 
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Step 2. Set up your chip-selects 

The 68302 has 4 chip-selects, only one of which is enabled after a reset condition. 
Nearly all 68302 target systems rely on at least one chip-select for accesses to 
memory. If you are going to access any target memory that relies on a chip-select, 
then you MUST be sure that the appropriate chip-select registers are initialized 
first. In some cases, even executing code from emulation memory will require that 
you first initialize your chip selects. This can be done in one of two ways: 

Method 1 : Using a Command File to Setup Chip-Selects: 

Use a series of commands or a command file that modifies the registers to the 
values you will need. For example, here is a command file that sets up CSO and 
CS1. 

reset <RETURN> 
break < RET URN > 

modify register r302 bar to 800H <RETURN> 
modify register chip_sel orO to 3FC2H <RETURN> 
modify register chip_sel brO to 0001H <RETURN> 
modify register chip_sel orl to 1F8 0H <RETURN> 
modify register chip_sel brl to 0801H <RETURN> 

Note It is important that you first modify the BAR register BEFORE you attempt to 

modify the chip-select registers because the location of those registers is calculated 
based on the value in the BAR. 



The above example will map the Internal system registers to location 800XXXH, 
and then initialize CSO as a read-only, 1 wait-state block from 0 through 01FFFFH 
and CS1 as a read-write, 0 wait-state block from 400000H through 43FFFFH. 

If you are going to load your initialization code into target RAM using the 
emulator, then you must use Method 1 . 

Method 2: Using Your Initialization Code to Setup Chip-Selects: 

Execute a small section of your initialization code that sets up the proper values in 
the chip select registers, and break into the monitor immediately after that, using 
either a software or analysis breakpoint. 
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For example, assuming you have the area from 0 through 01FFFFH mapped as 
emulation ROM and have already written your code to initialize the chip-select 
registers, you should load that code, set a breakpoint, and then run from a reset 
condition. When the breakpoint is hit the chip-selects will have been properly 
initialized. Here is an example program that will demonstrate this: 



XDEF 




CS INIT 






ORG 




$0 






DC . L 




$440000 


; Stack 


begins at $43FFFE 


DC . L 




$400 


; Reset 


initialization code 


ORG 




$400 






MOVE 


W 


#$0800, $F2 


; Set up the BAR for $800XXX 


MOVEA . L 


#$800000, AO 






MOVE 


W 


#$3F02, ($832, AO) 


; OR0 - 


512K, read-only, 1 wait-state 


MOVE 


W 


#$0001, ($830, AO) 


; BR0 - 


base address 0 


MOVE 


w 


#$1F80, ($836, AO) 


; OR1 - 


256K, read-write, 0 wait-state 


MOVE 


w 


#$0801, ($834, AO) 


; BR1 - 


base address $400000 


NOP 










NOP 










NOP 











Assuming you have loaded the above example into emulation memory, you can 
now use the commands: 

modify software_breakpoints enable <RETURN> 
modify software_breakpoints set CS_INIT <RETURN> 
run from reset <RETURN> 

If your initialization code is loaded in target ROM, you will not be able to set a 
software breakpoint there. In this case, you should use an analysis breakpoint as 
shown in the example below: 

trace about CS_INIT break_on_trigger <RETURN> 
run from reset <RETURN> 



Note When using the trace command with the "break_on_trigger" option, be sure to 

select an address that is at least 2 words after the instruction you expect to be 
executed. This ensures that the analyzer does not break on a "prefetch" of that 
instruction. 



When the emulator breaks into the monitor the chip-select registers will have been 
initialized to the values you're using. You can now use display, modify, load, step, 
or run commands because the chip-selects are properly initialized. 
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Failure to setup the chip-select registers is by far the most common cause of 
problems when using the 68302 emulator. If you remember that load, 
modify/display, step, and run commands often rely on valid chip-select settings, 
you can avoid most of the common mistakes made by users. 
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Step 3. Reprogram chip-select base addresses 

If you are not going to be changing the base address of chip-select 0 from address 
0, or changing the base address registers of the other chip-selects after initial setup, 
you should skip this step. Dealing with chip-selects whose base addresses are 
being changed is probably the most difficult challenge you will face with the 68302 
emulator. 

Before you can successfully emulate in this mode, it is important that you 
understand how the 68302 uses chip-selects. When you enter memory map terms 
in your configuration, you will notice that you enter all address ranges without the 
option to qualify a specific range with a chip-select number. What this means is 
that the emulation memory mapper cannot "track" changes made to the base 
address of any chip-selects. Any emulation memory ranges you map respond based 
on the value on the address bus (and optionally the function code). The chip-select 
signals are not used by the emulator to decode memory map terms. 

What does this mean? This means that if you are going to be mapping a block of 
memory to either emulation RAM or emulation ROM and are going to be changing 
the base address of that block, you must ensure that valid code or data exists at 
BOTH blocks of memory. For example, if you have boot code that originally exists 
at address 0 and chip-select 0 is later reprogrammed with a base address of 
400000H you must ensure that the code exists at both 0 and at 400000H. If you are 
executing your code from target memory, this is easy, since your target hardware 
will be designed to decode memory based on chip-select 0 being active, not based 
on the full address (A23-A1). 

Here is an example of how you can emulate a setup where the chip-select base 
addresses are being changed. The technique of switching the RAM and ROM 
addresses closely follows an example that Motorola provides in Revision 2 of the 
MC68302 User's Manual. 

We start with the following memory map: 

000000H thru 0 0FFFFH emulation ram 
400000H thru 41FFFFH emulation ram 
800000H thru 8 0 0FFFH target RAM 

and use the following program: 
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RESET 



DO_COPY 



CS_INIT 



XDEF 


bWl 1 LHilU 




ORG 


£■ A A A A A A 
b 4 U U U U U 




DC . L 


9IUUUU 


; Stack begins at $0FFFE 


DC . L 


Khj oili 1 — 941UUUUU 


; Reset initialization code 


DC . L 


bU b HiKKUK 




DC . L 


AJJJJK HiKKUK 




ORG 


£• A A A A A A 

9 4 U U 4 U U 




MOVE . W 


#$0800, $F2 


; Set up the BAR for $800XXX 


MOVEA . L 


#$800000, AO 




MOVE . W 


#$3FC2, ($832, AO) 


; OR0 - 128K, read-only, 1 wait-state 


MOVE . W 


#$0001, ($830, AO) 


; BR0 - base address 0 


MOVE . W 


#$1FE0, ($836, AO) 


; OR1 - 64K, read-write, 0 wait-state 


MOVE . W 


#$0801, ($834, AO) 


; BR1 - base address $400000 


NOP 






MOVEA . L 


#0,A3 


; pointer to vector table 


MOVEA . L 


#$400000, A4 


; where to copy it 


MOVE . L 


(A3) +, (A4) + 




CMPA. L 


#$400, A3 


; at the end? 


BNE 


DO_COPY 




NOP 




; now the vector table is in ROM and RAM 


NOP 






NOP 







the following instructions move code into on-chip RAM, then jump to it. 
A2 is used to point to where ROM WILL be. 



SWITCHED 



MOVEA . L 
MOVEA . L 



MOVE . L 
MOVE . L 
MOVE . L 
MOVE . W 
JMP 
NOP 
NOP 
NOP 

MOVE . L 
NOP 



#SWITCHED, A2 
AO, Al 

#$317CA001, (Al) + 
#$0834317C, (Al) + 
#$C8010830, (Al) + 
#$4ED2, (Al) + 
(AO) 



0,D0 



; it's switched now! !!!!!! 
; read vector 0 



BUS_ERROR JMP 
ADDR_ERROR JMP 



BUS_ERROR 
ADDR_ERROR 



What happens first? The first thing that needs to be done is for you to copy your 
startup code that will exist in ROM beginning at 400400H to address 400H because 
what will eventually be address 400400H is address 400H immediately following a 
reset (because chip-select 0 maps to address 0). To do this, you can use a command 
that is only available from the terminal interface or pod command. Execute the 
command: 

pod_command "cp 0=400000 .. 401fff" <RETURN> 

This will cause the first 8 Kbytes of code that was loaded at 400000H to be copied 
to emulation RAM beginning at 0. Doing this will make the emulator act like your 
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target system will at reset. Now you can simply set a breakpoint, and then run from 
reset using the commands: 

modify softwar&_breakpoints enable <RETURN> 
modify software_breakpoints set SWITCHED <RETURN> 
run from reset <RETURN> 

When the emulator breaks into the monitor, chip-select 0 will have been 
programmed for address range 400000H through 41FFFFH and chip-select 1 will 
have been programmed for address range 0 through OFFFFH. Your program can 
now modify RAM at address 0. 

Note that an important limitation of this method is that if a target system reset 
occurs while your program is running, the program will fail. This is because after a 
reset, chip-select 0 will again map to address 0, but your code is no longer at 
address 0. In order to put your code at 0, you would again need to issue the 
command: 

pod_command "cp 0=400000 .. 401fff" <RETURN> 

There are other ways that you can debug a system that reprograms the base 
addresses of chip-selects. Another approach would be to debug your system in two 
separate steps. First, you can debug your initialization code. Once your 
initialization code is debugged, you can configure the emulator and map memory 
based on what your final chip-select addresses will be. You can then use a 
command file to set the chip-selects to their final addresses. This may require some 
vector table changes. 

Still another approach is to use only target memory in areas where chip-selects are 
used. This doesn't require any special steps because your target memory will 
"track" the chip-select changes. 
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Step 4. Know your interrupt mode 

If your target does not use dedicated mode interrupts, you can skip this step. 

One of the more common problems users encounter is not being able to break into 
the monitor (ERROR: break failed). A common cause of this is configuring the 
emulator for dedicated mode interrupts, but failing to ensure that the 68302 is 
programmed for dedicated mode interrupts. 

The emulator is configured to use normal mode interrupts by default. If you will be 
setting up the 68302 for dedicated mode interrupts, you should answer the 
configuration question: 

Interrupt mode? 
with the choice "dedicated". 

The interrupt mode of the 68302 is determined by the value programmed in the 
GIMR register. If you are using dedicated mode interrupts, you must set the most 
significant bit of the GIMR register BEFORE you attempt to step or break. Similar 
to setting up chip-selects, you have two options for making sure you have a valid 
interrupt mode: 

Method 1 : Using a Command File to Set the Interrupt Mode 

Use a series of commands or a command file that modifies the GIMR to force the 
68302 to be in dedicated mode. For example, here is a command file that sets up 
the GIMR for dedicated mode: 

reset <RETURN> 
break < RET URN > 

modify register r302 bar to 8 0 OH <RETURN> 
modify register interrupt gimr to 87 0 OH <RETURN> 



Note It is important that you first modify the BAR register BEFORE attempting to 

modify the GIMR register because the location of that register is calculated based 
on the value in the BAR. 



Note that doing a break when the 68302 is in a reset state does not require a level 7 
interrupt, and therefore will work regardless of the interrupt mode setting. 
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Method 2: Using Your Initialization Code to Set the Interrupt Mode 

Execute a small section of initialization code that sets the GIMR register to the 
proper value, and break into the monitor immediately after that using either a 
software or analysis breakpoint. 

Here is an example that shows how this works using an analysis breakpoint. In this 
case, an analysis breakpoint is useful because it will confirm that everything is 
working properly (if you use a software breakpoint, the emulator does not issue a 
level 7 interrupt, so that would not test the interrupt mode): 

Start with the following program loaded in either emulation or target memory: 



XDEF CS_INIT, GIMR_INIT 

ORG $0 

DC.L $440000 ; Stack begins at $43FFFE 

DC.L $400 ; Reset initialization code 



CS_INIT 



GIMR_INIT 



ORG 




$400 






MOVE 


W 


#$0800, $F2 


; Set 


up the BAR for $800XXX 


MOVEA . L 


#$800000, AO 






MOVE 


w 


#$3F02, ($832, AO) 


; OR0 


- 512K, read-only, 1 wait-state 


MOVE 


w 


#$0001, ($830, AO) 


; BR0 


- base address 0 


MOVE 


w 


#$1F80, ($836, AO) 


; OR1 


- 256K, read-write, 0 wait-state 


MOVE 


w 


#$0801, ($834, AO) 


; BR1 


- base address $400000 


NOP 










NOP 










NOP 










MOVE 


w 


#$8740, ($812, AO) 


; set 


for dedicated mode interrupt 


NOP 










NOP 










NOP 










NOP 










NOP 










NOP 











Assuming you have loaded the above example into emulation or target memory, 
you can now use the commands: 

trace about GIMR_INIT break_on_tr±gger <RETURN> 
run from reset <RETURN> 

When the emulator breaks into the monitor, the 68302 will be in dedicated mode. 
You can now use the step and break command. 

Note that if you are just starting to debug your initialization code, and would like to 
step through each of your startup instructions, you should use Method 1 . 
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Step 5. Decide whether to use the foreground 
monitor 

The default configuration for the 68302 emulator uses the background monitor. 
The background monitor is easier to use and usually requires no special setup. 

The foreground monitor offers you much more flexibility but also requires extra 
setup and sometimes requires more in-depth knowledge of your target system. You 
should use the foreground monitor if any of the following are true: 

• Your target system has DRAM, and you use the built-in DRAM refresh of the 
68302 to refresh it 

• You need to service some type of interrupt even when you are running in the 
monitor. An example of this is might be a timer interrupt that MUST be 
serviced on a regular interval 

• You need to have SCC functions occurring while you are running in the 
monitor 

• You need to customize the monitor to provide some special function, such as 
servicing an off-chip watchdog timer 

• You have frequent external interrupts occurring and this prevents you from 
being able to single-step correctly. This problem can occur when external 
interrupts are left pending during background execution. The problem will 
appear as a PC that is "stuck" at the same address after each step command. 
(One solution to this problem is to modify the processor status register to raise 
the interrupt mask before stepping, and then restoring it after you are finished 
stepping.) 

Note that some users choose the foreground monitor so that they can customize it to 
refresh the on-chip watchdog timer of the 68302; however, this is not necessary. 
The 68302 SCR register contains a bit which, when set, will suspend the watchdog 
timer whenever the FRZ pin is asserted. This bit is called "FRZW". You can 
simply modify your code to set that bit on startup, and the watchdog timer will 
automatically be suspended when you are in the background monitor. 

If you do choose to use the foreground monitor, you cannot take advantage of the 
FRZW feature since the FRZ pin is only asserted in the background monitor. Note 
that the FRZ1 and FRZ2 bits of the SCR can likewise be used to suspend timerl 
and timer2 during background operation. 
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Step 6. Set up the emulator for the foreground 
monitor 

Skip this step if you have decided not to use the foreground monitor. 

Here are the steps you should follow if you choose to use the foreground monitor: 

1 Choose an address for the monitor. Unlike the background monitor, the foreground 
monitor resides in the same memory space as your program (hence the term 
"foreground"). You must first select the address where the monitor will reside. 
Here are some considerations: 

• The monitor MUST reside in emulation memory. Note that when you 
configure the emulator and answer the questions regarding the foreground 
monitor, the memory map will automatically be modified to include a block of 
emulation RAM for the monitor. 

• All monitor cycles (both reads and writes) WILL be seen by your target 
system; therefore, you must choose an address that your target system will 
"tolerate". For example, if your target has a range of memory that is decoded 
for read-only accesses, you should not locate the monitor there. 

• You should not locate the monitor in area that your program may overwrite. 
The monitor must be mapped to emulation RAM, so you must be careful to not 
allow it to get overwritten. 



Note If you are using 1 Mbyte SIMMs in your 68302 emulator, you MUST locate the 

monitor on an 8 Kbyte boundary, otherwise locate the the monitor on a 2 Kbyte 
boundary. 



Note A defect in firmware revision A.00.03 of the 68302 emulator will prevent the 

monitor from successfully loading at any address whose first non-zero digit is not 
numeric. For example, you would not be able to locate the monitor at 0A0000H, 
0B0000H, 0A000H, etc. You could load it at address 1 A0000H, 3B0000H, etc. To 
check the revision of your 68302 firmware issue the command "ver" from the 
terminal interface This problem does not exist in firmware revision A.00.04. 
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2 Make a local copy of the monitor source file. For Motorola syntax assemblers use 
the file $HP64000/monitor/Mfmon68302.s, and for the HP OLS assembler use the 
file $HP64000/monitor/fmon68302.S . 

3 Modify the monitor source file. You need to uncomment the "ORG" directive and 
put the address chosen in step number 1 in the address field. 

4 Assemble and link the monitor. 

For the HP AxLS assembler, use the command: 

$ as68k -L Mfmon68302.s > Mfmon68302 . 0 <RETURN> 

For the Microtec 68000 assembler, use the command: 

$ asm68k -L Mfmon68302.s > Mfmon68302 . 0 <RETURN> 

For the HP OLS assembler, use the command: 

$ asm -o fmon68302.S > fmon68302.O <RETURN> 

5 Link the monitor. 

For the HP AxLS linker, use the command: 

$ ld68k -h -o Mfmon68302 Mfmon68302.o <RETURN> 
For the Microtec linker, use the command: 

$ lnk68k -h -o Mfmon68302 Mfmon68302.o <RETURN> 

Note You must use the -h option. This forces the output file to be an "HP OLS" file (.X 

extension) 

For the HP OLS Linker, use the command: 
$ Ink <RETURN> 

and then simply follow the prompts. 



162 



Chapter 5: Plugging into a Target System 
Configuring the Emulator for In-Circuit Operation 

6 Modify your emulator configuration to specify a foreground monitor and specify 
the address you chose and the filename you created (in this example the filename is 
Mfmon68302.X for the Microtec or HP AxLS linker). 

7 Make sure that the address range 0FFF000H through OFFFFFFH is mapped as 
"target RAM". This is important because the emulator will attempt to access the 
on-chip locations of the 68302 upon entering the monitor. It uses the default 
address for the BAR, placing the internal register section at address 0FFF000H. 
Leaving this as guarded will cause a guarded access error — mapping it to 
emulation RAM will cause unpredictable results. 

If You Plan to Single-Step: 

If you plan to single-step when using the foreground monitor, there's one more 
thing you need to do. You need to ensure that the vector table entry at location 24H 
points to the label "TRACE_ENTRY" in the foreground monitor module. You can 
determine what this address is by looking at the listing file created when you 
assembled the monitor. There are many approaches you can take to ensure this, 
including: 

• Modify your own code to place the value of TRACE_ENTRY at location 24H. 
This is probably the most "robust" method because you can account for things 
such as a RAM-based vector table that is loaded by your initialization code. 

• Use a modify memory command to put the value of TRACE_ENTRY at 24H 
after loading your program. This works fine if your program doesn't overwrite 
or re-initialize the vector table during execution. 
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• Use a command file to single step that first modifies memory location 24H to 
point to TRACE_ENTRY, then step. For example: 

modify memory 2 4H long to XXXXXXH <RETURN> 
step <RETURN> 

where XXXXXXXH is the address of TRACE_ENTRY. 

You shouldn't need to use this method unless your program or operating system is 
continuously changing the vector table contents. 

If you are mapping the vector table to a target ROM area and are not able to modify 
location 24H, you can map the vector table area to emulation RAM, copy the 
contents of your target ROM to emulation RAM, then modify location 24H. Here 
are the steps needed to do this: 

1 Map 0 through 3FFH as emulation RAM. 

2 Use the commands: 

pod_command "cim 0..03ff" <RETURN> 

modify memory 2 4H long to XXXXXXH <RETURN> 

where XXXXXXXH is the address of TRACE_ENTRY. 



Note The terminal interface or pod_command "cim" is a special command that allows 

you map a section of memory as emulation RAM or ROM and copy the contents of 
your target memory to that section. In this example, the cim command is used to 
read all locations 0 through 3FFH from your target ROM, then write those values to 
emulation memory. This is a convenient way of making changes to your target 
ROM without having to burn new ROMs. 
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If You Need Interrupts Serviced While Running in the Monitor 

By default, the foreground monitor leaves the Interrupt Mask of the 68302 at 7 after 
a "break" into the monitor. If you wish to have any interrupts other than level 7 
interrupts serviced while the monitor is running, you must modify the monitor 
source code. The monitor source has the following instructions commented out: 

; MOVE.W PSTAT,D0 

; OR #0F8FFH,D0 

; MOVE.W SR,D1 

; AND D1,D0 

; MOVE.W D0,SR 

Simply uncomment the instructions shown above, reassemble and relink the 
monitor, then reload your configuration. 

Note that the monitor is not re-entrant. This means that you should be careful not 
to cause a "break" into the monitor at a time when your program may have 
interrupted the monitor. An example of this would be a case where you set a 
breakpoint inside one of your interrupt service routines, and that interrupt service 
routine gets called as a result of an interrupt to the monitor program. 
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Step 7. If you use the 68302 built-in DRAM refresh 

The 68302 has a special built-in function that allows for automatic refresh of 
DRAM with no additional target hardware. If your target system does not rely on 
this built-in feature of the 68302, you can skip this step. If you do use the built-in 
DRAM refresh feature, you must use the foreground monitor; otherwise, DRAM 
values will become corrupted when you break into the background monitor. 

In order to make the DRAM refresh work, you should follow the steps outlined in 
"Step 6. Set up the emulator for the foreground monitor". You will need to make 
one addition to the foreground monitor source code to ensure that DRAM refreshes 
occur properly while in the monitor. To make the addition, edit the monitor source 
and find the following section: 



TARG_MEM_WR 

MOVE.L TARG_S TART , AO 

MOVE.L #XFR_BUF,A1 

MOVE.W TARG_BYTES, A2 

CMP.W #00800H,A2 

BPL TARG_WORD_WR 



Then, add the next two lines immediately after the BPL instruction: 

CMPA.L #$F2,A0 ; If write to 0F2H, force a word write 

BEQ TARG_WORD_WR 



Why is this needed? Whenever a break into the monitor occurs, the emulator 
always checks the value in the BAR and rewrites it. Without this addition, the 
emulator will make two separate byte accesses to locations 0F2H and 0F3H. If a 
DRAM refresh occurs in between the write to 0F2H and 0F3H, the DRAM refresh 
operation will not function properly. Making this change ensures that a DRAM 
refresh will not occur during a write to the BAR. 

After making this change, you should reassemble and relink the monitor; then, 
reload your configuration. 
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Step 8. Set up the DTACK signals 

Probably the least understood questions asked during the configuration process 
relate to the interlocking and source for the DTACK signal. Answering these 
questions correctly is easy once you know a little bit about your target system. 

You will have to answer the following four questions: 

/DTACK source for csO? internal or external 

/DTACK source for csl? internal or external 

/DTACK source for cs2? internal or external 

/DTACK source for cs3? internal or external 

Answering these questions is easy. If you will be programming a chip-select to 
generate DTACK internally (as is most often the case), you should answer 
"internal"; otherwise, answer "external". You may notice that the default for csO is 
"internal" and all others "external". This is because the 68302 csO is configured to 
generate an internal DTACK by default. 

A somewhat more difficult question you will also be asked is: 
Interlock emulator DTACK with user DTACK? 

Answering yes to this question will force the emulator to wait for your target 
system to assert the DTACK signal whenever an access occurs to emulation 
memory AND there is no internally generated DTACK for this cycle. 

The default answer is "no" and can most often be left as such. When do you need 
to answer yes? If ALL of the following are true: 

1 Your target system asserts DTACK for some area of memory. 
AND 

2 Your target system inserts at least one wait state for that area. 
AND 

3 You are going to map that area as emulation RAM or emulation ROM. 

What does this do? Interlocking DTACKs simply will ensure that the emulation 
memory accesses to this area will have the same number of wait states as your final 
target does. 

What will happen if ALL of the above are true and you do not interlock DTACKs? 
In the best case scenario, your code will run faster in the emulator than it will in 
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your actual target. This is because an area mapped as emulation memory will 
always terminate with 0 wait states, even if it overlays an address where your target 
system inserts wait states. Interlocking DTACKs will ensure that the emulation 
memory accesses have the same number of wait states as your target memory. 

In the worst case scenario, where you should, but do not, interlock DTACKs, reads 
or writes to your target memory will fail. This can happen if your target system 
DTACK circuitry gets confused when the emulator fails to "wait" for your target 
system to assert DTACK. 
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Step 9. If emulator status shows HALTED 

Most users will encounter a status of "M68302-Halted" at one time or another. 
This almost always is caused by a double -bus fault, although under rare conditions 
it can be caused by the target asserting the "HALT" pin. Note that the 68302 
emulator NEVER asserts the HALT pin itself. 

A double-bus fault occurs if the 68302 encounters an exception while processing 
another exception. For example, if a bus-error occurs and the 68302 begins to 
process that bus error, then fetches an odd-address from the vector table location 
08H, a double-bus fault will occur. 

Most users will encounter a halted condition at least once. You can avoid this 
problem by making sure you have a "good" stack (that includes making sure that 
any needed chip-selects are programmed BEFORE any stack accesses occur) and 
making sure that your bus error and address error exception vector table entries (at 
08H and OCH) point to valid addresses. 

If you are encountering a "M68302-Halted" condition you should initiate an 
analyzer trace before you run or step. Use the command: 

trace on_halt <RETURN> 

This trace command means "trace all cycles, but NEVER trigger" and is useful 
because when the processor halts, the analyzer will have the last X states (based on 
which type analyzer card and mode you are using) in its buffer. By simply 
stopping or halting the trace manually, you will be able to unload this buffer and 
see exactly what caused the double-bus fault. 

The 68302 will halt itself if a double-bus fault occurs. Only a target system reset, 
or emulator reset command will clear the "Halted" condition. 
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Here is an example where a "trace onjialt" command was used to find the cause of 
a double-bus fault: 



CS_INIT 



XDEF 




CS INIT, GIMR INIT 




ORG 




$0 




DC . L 




$440000 


Stack begins at $43FFFC 


DC . L 




$400 


Reset initialization code 


ORG 




$400 




MOVE 


W 


#$0800, $F2 


Set up the BAR for $800XXX 


MOVEA . L 


#$800000, AO 




MOVE 


w 


#$3F02, ($832, AO) 


OR0 - 512K, read-only, 1 wait-state 


MOVE 


w 


#$0001, ($830, AO) 


BR0 - base address 0 


MOVE 


w 


#$0001, - (A7) 


push parameter 


JSR 




CHKSUM 


jump to checksum subroutine 


MOVE 


w 


#$1F80, ($836, AO) 


OR1 - 256K, read-write, 0 wait-state 


MOVE 


w 


#$0801, ($834, AO) 


BR1 - base address $400000 


NOP 








NOP 









The memory map used in this configuration includes: 

000000H thru 1FFFFH emulation ram 
400000H thru 4 3FFFFH target ram 

The commands issued were: 

trace on_halt <RETURN> 
run from reset <RETURN> 

after which the status line will show "M68302-Halted". At this point, you must 
"halt" and display the trace using the commands: 

stop_trace <RETURN> 
display_trace <RETURN> 
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Looking at the trace we see: 



Trace List Depth=512 
Label: Address 



Of f set=0 

Opcode or Status w/ Source Lines 



More data off screen 
time count 



Base : 


hex 




mnemonic 


relative 


-014 


00040C 


MOVE . W 


#03F02, 00832 (AO) 




640 


nS 


-013 


00040E 


3F02 


sprog rd word 




600 


nS 


-012 


000410 


0832 


sprog rd word 




640 


nS 


-Oil 


000412 


MOVE . W 


#00001,00830 (AO) 




600 


nS 


-010 


800832 


3F02 


sdata wr word 


IAC 


280 


nS 


-009 


000414 


0001 


sprog rd word 




280 


nS 


-008 


000416 


0830 


sprog rd word 




320 


nS 


-007 


000418 


MOVE . W 


#00001, - (A7) 




320 


nS 


-006 


800830 


0001 


sdata wr word 


IAC 


240 


nS 


-005 


00041A 


0001 


sprog rd word 




320 


nS 


-004 


00041C 


JSR 


0000446 




320 


nS 


-003 


00041E 


0446 


sprog rd word 




320 


nS 


-002 


43FFFE 


0001 


sdata wr word 




1 . 


02 mS 


-001 


43FFFC 


041E 


sdata wr word 




1 . 


02 mS 


STATUS : 


M68302- 


—Halted 




Emulation trace halted 







What to look for: 
Label/Base -007 



Label/Base -002 



Label/Base -001 



A push of 0001 onto the stack is initiated. The stack 
pointer is already set to 44000H. The memory below there 
is accessed using chip-select 1 , but the registers for 
chip-select 1 have not been initialized yet. 

The processor does a write of 0001 to location 43FFFEH as 
a result of the instruction at -007, but because the the 
chip-select that would provide DTACK has not yet been 
initialized, the cycle is not terminated normally. The 
1 .02mS time count is indicative of an internally generated 
bus error (BERR). 

Because of the bus error in the previous cycle, the 68302 
will immediately begin to process a bus error exception. 
The first thing it will try to do is write the low word of the 
program counter value to the stack. But again, since the 
chip-select register has not been initialized this stack write 
will also fail with a bus error, hence the double-bus fault! 
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Note In a case like this where there was no trigger, the emulator does not know which 

line in the trace to begin disassembly on. In this example you would need to issue 
the command: 

display trace disassemble_from_line_number -14 <RETURN> 

in order to get the display shown above. Choosing the trace line number to begin 
disassembly from is not always easy. You need to choose a line number which has 
the fetch of the first word of an instruction. You may recognize symbols in your 
trace, or specific opcode values. Note that when you are tracing high-level routines 
such as a C routine, the emulator can use source-line information to help it choose 
the proper location for disassembly. 



This trace shows how valuable the time stamp can be, not just in highlighting 
cycles that are unusually long, but also in showing the effect of reprogramming of 
OR1 . You can see how the program fetch on line -Oil took approximately 600ns, 
but the program fetch on line -009 took only 280ns. This is a result of the write to 
OR1 on line -010 which changed the internal DTACK generation from 6 wait states 
to 1 state. 

Many users capture a trace that shows the processor halting, but fail to take the time 
to analyze the information in the trace. Examining a trace carefully will often help 
you find the exact cause of a problem. 
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Step 10. Choose the correct target memory 
access size 

Whenever the emulator accesses either target memory or an on-chip location, it 
uses the monitor program to do so. The monitor program will use either a 
"MOVE.B" or "MOVE.W" instruction for this access. You can control this by 
answering the configuration question: 

Target memory access size? 

as either "bytes" or "words". The default value is "bytes", and this should be 
acceptable for most cases. There are cases, however, where a target system design 
allows only word accesses to a particular area of memory, and you may wish to 
answer this question as "words". You may also find that you need the access size 
set to "bytes" sometimes and "words" at other times. If you find that this is the 
case, you can use the commands: 

pod_command "mo -ab" <RETURN> 

to set the access size to bytes, or 
pod_command "mo -aw" <RETURN> 

to set the access size to words. This will allow you to control the access size 
without having to modify your configuration. 



Note If you find that you need to change the access size often, you may want to create an 

action key for each size in the Graphical User Interface, or create two command 
files that contain the appropriate pod_command commands. 
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Step 11. Check your DTACK pullup resistor! 

It wouldn't be fair to solve all these 68302 plug -in problems and not give the 
hardware engineer a chance to help out, so there's one last thing you should check 
before you begin. 

Different than the typical 68000 family device, the DTACK signal on the 68302 is 
bi-directional and will be driven low by the 68302 on all cycles where DTACK is 
internally generated. This calls for an open-collector design in almost all cases. 
Have your hardware engineer check the value of the pull-up resistor used on the 
DTACK signal and make sure that it is approximately IK ohms. Any value higher 
than IK ohms will likely cause problems. 

Lowering the value of the pullup resistor ensures that the DTACK signal rises 
quickly enough. If the DTACK signal rises too slowly you may see incorrect reads 
from target memory. Why is this? The emulator does alter the characteristics of 
the DTACK signal (higher capacitive loading and different drive characteristics) 
and can prevent the DTACK signal from rising to a logic high before the next cycle 
starts. If DTACK is still seen as a logic low when the next cycle starts that cycle 
may be terminated with 0 wait states. 

The diagram below shows how a DTACK signal that does not rise quickly enough 
can cause problems. On the start of the second cycle the DTACK signal is still 
seen as low. Even if this is an address configured for a chip-select that has an 
internally generated DTACK, the slow rising external DTACK will cause problems 
because the 68302 will sample the DTACK as an input even on cycles programmed 
for internal DTACK generation. A cycle that should have been a 1 wait-state cycle 
terminates without any wait-states and results in bad data being read. 




C50 
DTACK 



DTACK should be high by now 
Bui the 68302 still sees it low here 



A 



64 7 46b0Z 
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If you have problems 

Listed below are common problems and their most common causes: 

PROBLEM: You get "ERROR: Stepping failed" when trying to use "step" or 
"step from" command. 

Cause: This is most likely caused by an invalid stack. In order to step, 

the emulator will first modify the values on the stack, and then 
execute an RTE. If the stack pointer points to an invalid 
address, or the chip-select needed to access the stack are not 
initialized, the stack reads that result from the RTE will result in 
a double-bus fault. 

Fix: Make sure the stack pointer is pointing to a legitimate address 

and that any chip-selects for that address are initialized. 

PROBLEM: You get "ERROR: Break failed" when trying to step. 

Cause: You have configured the emulator for dedicated mode 

interrupts but have not put the 68302 in dedicated mode by 
modifying the GIMR and setting the most significant bit. Or, 
the instruction that you single-stepped resulted in a double -bus 
fault and the processor is now halted. 

Fix: Make sure that the processor is set for the correct interrupt 

mode before single-stepping. If the interrupt mode is correct, 
then use the trace command before stepping so that you see 
what went wrong. 

PROBLEM: You get "ERROR: BERR during background access to 
supervisor stack" when you first try to step or run. 

Cause: This problem occurs when the emulator attempts to modify the 

stack so that your run or step command will begin from the 
proper address. The emulator will try to modify the stack and 
then use an RTE to force the program counter and status 
register to the proper values. In this case, a bus error occurred 
when the emulator attempted to modify the stack. 
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Fix: Make sure the stack pointer is pointing to a legitimate address 

and that any chip-selects for that address are initialized. 

PROBLEM: You get "ERROR: Monitor failure; bus error" when trying to do 
a display, modify or load command. 

Cause: This error means that when the emulator tries to read from or 

write to a memory location mapped as target RAM or ROM, a 
bus error exception occurred. This can have many causes, but 
most often is caused when you try to access memory that relies 
on a chip-select signal, but have not initialized the chip-select 
registers first. 

Fix: Make sure that your chip-select registers are properly initialized. 

PROBLEM: Whenever you break into the monitor, you have problems with 
the SCC portion of your program. 

Cause: The emulator asserts the FRZ pin when it breaks into the 

monitor and this in turn "freezes" the Communications 
Processor. Based on what type of SCC setup you have, and 
what type of activity is occurring at the time of the break, you 
may experience unexpected SCC errors or activity. Note that if 
you are using the background monitor, the FRZ is asserted 
during the entire time the emulator is running in the monitor. If 
you are using the foreground monitor, the FRZ pin is asserted 
for a short time during transition from your program to the 
monitor program (approximately 30 CPU cycles). 

Fix: Either use the foreground monitor, which will reduce but not 

eliminate the time that the FRZ pin is asserted, or avoid setting 
any breakpoints while debugging SCC functions. By using the 
trace analyzer, you can capture a real-time log of SCC-related 
bus activity. 

PROBLEM: You are using the DRAM refresh controller of the 68302, but 
when you break into the monitor, the values in your DRAM become corrupted. 

Cause: You are either using the background monitor, or have not made 

the proper modification to the foreground monitor. 
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Fix: Use the foreground monitor and include the necessary 

modifications. Refer to "Step 7. If you use the 68302 built-in 
DRAM refresh" for details on how to ensure proper DRAM 
refresh. 

PROBLEM: The emulator status line shows "M68302--Halted" 

Cause: A double-bus fault has occurred, or the target system has 

asserted the HLT pin. This is almost always caused by a 
double-bus fault. Most often a bus error or address error 
exception fails to complete correctly because of an invalid stack 
or vector table entry. 

Fix: Make sure you have a valid stack and valid vector table entries. 

Refer to "Step 9. If emulator status shows HALTED" for 
troubleshooting information. 

PROBLEM: Incorrect data is read from target RAM or ROM. 

Cause: This is most often caused by a slow rising DTACK signal. The 

DTACK signal is usually pulled high with a resistor. Any 
resistor value above IK ohms will usually result in some target 
memory cycles that are terminated with 0 wait states regardless 
of how the chip-select registers are programmed. 

Fix: Make sure that the pullup resistor on DTACK is no higher than 

IK ohms. Refer to "Step 1 1. Check your DTACK pullup 
resistor!" for more information. 
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This chapter describes general tasks you may wish to perform while using the 
emulator. These tasks are grouped into the following sections: 

• Loading absolute files. 

• Using symbols. 

• Executing user programs (starting, stopping, stepping, and resetting the 
emulator). 

• Using software breakpoints. 

• Displaying and modifying registers. 

• Displaying and modifying memory. 

• Changing the interface settings. 

• Using system commands. 
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Loading and Storing Absolute Files 

This section describes the tasks related to loading absolute files into the emulator 
and storing memory contents into absolute files. This section shows you how to: 

• Load absolute files into memory. 

• Load absolute files without symbols. 

• Store memory contents into absolute files. 



To load absolute files 

• Choose File— >Load— ^Executable and use the dialog box to select the absolute file. 

• Using the command line, enter the load <absolute_file> command. 

You can load absolute files into emulation or target system memory. You can load 
IEEE-695 format absolute files. You can also load HP format absolute files. The 
store memory command creates HP format absolute files. 

If you wish to load only that portion of the absolute file that resides in memory 
mapped as emulation RAM or ROM, use the command line's load emul_mem 

syntax. 

If you wish to load only the portion of the absolute file that resides in memory 
mapped as target RAM, use the command line's load user_mem syntax. 

If you want both emulation and target memory to be loaded, do not specify 
emul mem or user_mem. 



Examples To load the demo program absolute file, enter the following command: 

load ecs.x <RETURN> 

To load only portions of the absolute file that reside in target system RAM: 
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load user_mem absfile <RETURN> 

To load only portions of the absolute file that reside in emulation memory: 
load emul_mem absfile <RETURN> 



To load absolute files without symbols 

• Choose File— >Load— ^Program Only and use the dialog box to select the absolute 
file. 

• Using the command line, enter the load <absolute_file> nosymbols command. 



To store memory contents into absolute files 

• Using the command line, enter the store memory command. 

You can store emulation or target system memory contents into HP format absolute 
files on the host computer. Absolute files are stored in the current directory. If no 
extension is given for the absolute file name, it is given a ".X" extension. 



Examples To store the contents of memory locations 900H through 9FFH to an absolute file 

on the host computer named "absfile": 

store memory 900h thru 9ffh to absfile <RETURN> 

After the command above, a file named "absfile.X" exists in the current directory 
on the host computer. 
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Using Symbols 

If symbol information is present in the absolute file, it is loaded along with the 
absolute file (unless you use the nosymbols option). Both global symbols and 
symbols that are local to a program module can be displayed. 

Long symbol names can be truncated in the symbols display; however, you can 
increase the width of the symbols display by starting the interface with more 
columns (refer to the "Setting X Resources" chapter). 

This section describes how to: 

• Load symbols. 

• Display global symbols. 

• Display local symbols. 

• Display a symbol's parent symbol. 

• Copy-and-paste a full symbol name to the entry buffer. 



To load symbols 

• Choose File— >Load— ^Symbols Only and use the dialog box to select the absolute 
file. 

• Using the command line, enter the load symbols <absolute_file> command. 

Unless you use the nosymbols option when loading absolute files, symbols are 
loaded automatically. However, if you did use the nosymbols option when loading 
the absolute file, you can load the symbols without loading the absolute file again. 

This option is particularly useful for loading symbols for files located in target 
ROM so that you can use symbols with that code. 
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Examples To load symbols from the demo program: 

load symbols ecs.x <RETURN> 



To display global symbols 

• Choose Display— ^Global Symbols. 

• Using the command line, enter the display global_symbols command. 

Listed are: address ranges associated with a symbol, the segment the symbol is 
associated with, and the offset of that symbol within the segment. 

If there is more than a screen full of information, you can use the up arrow, down 
arrow, <NEXT>, or <PREV> keys to scroll the information up or down on the 
display. 



Examples To display global symbols in the demo program: 

display global_symbols <RETURN> 



Global symbols in ecs.x 










Procedure symbols 










Procedure name 


Address 


range 


Segment 


Offset 


_f flush 


806FC8 - 


007061 


libc 


0000 


_buf sync 


B057EC - 


005817 


libc 


0080 


_dbl_t o_str 


005R5FI - 


005F3F 


libc 


0242 


_doprnt 


0061F4 - 


006F2B 


libc 


003E 


_exec_f uncs 


BB518H - 


0051RF 


libc 


0032 


_f i ndbuf 


BB7B62 - 


0070F9 


libc 


0000 


_startup 


082150 - 


002260 


env 


0000 


_swri te 


0072E8 - 


00731B 


libc 


0000 


wrtchk 


8B731E - 


007 360 


libc 


0000 


_xf lsbuf 


0073BR - 


00744F 


libc 


0000 


atexi t 


005158 - 


005188 


libc 


0000 


ca 1 loc 


8856C8 - 


005701 


libc 


040E 


c lear_screen 


882558 - 


000585 


env 


01CR 


c lose 


882428 - 


002455 


env 


009R 


combsort 


002E74 - 


003073 


prog 


02RC 


do_sort 


BB388B - 


003123 


prog 


04B8 
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To display local symbols 

• When displaying symbols, position the mouse pointer over a symbol on the symbol 
display screen and click the select mouse button. 

• When displaying symbols, position the mouse pointer over the symbol, press and 
hold the select mouse button, and choose Display Local Symbols from the popup 
menu. 

• Position the mouse cursor in the entry buffer and enter the module whose local 
symbols are to be displayed; then, choose Display— >Local Symbols (). 

• Using the command line, enter the display local_symbols_in <module> command. 

To display the address ranges associated with the high-level program's source file 
line numbers, you must display the local symbols in the file. 
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Examples 



To use the Symbols Display popup menu: 



View the local 
symbols associated 
with the highlighted 
symbol by choosing 
this menu item. 



Hewlett Packard Emulator/Analyzer: em68302 (m68302) 



File Display Modify Execution Breakpoints Trace Settings 



Help 



Action keys: | < Demo > [| DispSrcQ || Trace () [| Run || Step Source 



|<YourKey"T[| Make [[oTsp Src Prev[|Run Xferto ( )[| Break [| StepAsm 



(): 



Global symbols in ecs.x 
Procedure symbols 
Procedure name 

IP 

un 1 inl 



uj rite 

ujr i te_hdwr 



Address range Segment 

8857B2 - 8857EB libc 
0826RR - BB26EF 



Static symbols 
Symbol name 
?fl5 

JSR_ENTRY 

L 1 1 0_check_loop 

L_2_I 0_exi t_loop 
MBNITBR_MESSflGE 
TopBf Heap 
TopBf Stack 



heap 



STATUS: 



Build successful; no warnings were issued 



Recall 
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Using the command line: 

To display local symbols in a module: 

display local_symbols_in update_sys <RETURN> 



Symbols in updat e_sys(modu le ) 
Procedure symbols 



Procedure name 


Address 


range 


Segment 


Offset 


get_targets 


00329A - 


003323 


prog 


00CC 


graph_data 


083504 - 


00368D 


prog 


8406 


read_condi t i ons 


00332A - 


0033C9 


prog 


015C 


save_poi nts 


0034E8 - 


on 3 5 LCI 


prog 


831fl 


set_outputs 


B033D0 - 


003461 


prog 


8202 


update_system 


003 104 - 


003233 


prog 


0006 


wri te_hdwr 


003468 - 


0034E1 


prog 


02Sfl 



Filename symbols 

Fi lename 

update_sys. c 



To display local symbols in a procedure: 

display local_symbols_in update_sys . save_points <RETURN> 



Symbols in update_ 


_sys(module) 


save_poi nts ( procedur e) 




Procedure special 


symbo Is 






Procedure special 


name 


Address ranae Seament 


Offset 


ENTRY 




0034E8 prog 


031A 


EXIT 




0035CC prog 


03FE 


TEXTRANGE 




0034E8 - 0035CD prog 


031A 
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To display address ranges associated with the high-level source line numbers: 

display local_symbols_in update_sys . "update_sys . c" : 
<RETURN> 



Symbols in update 


_sys(modu le) 


"update_sys. c" : 






Source reference 


symbo Is 












Line range 


Address 


range 


Segment 


Offset 


81-847 




0831D4 




003 1F3 


prog 


0006 


848-853 




0031F4 




003207 


prog 


0026 


854-856 




003288 




003213 


prog 


003A 


857-859 




003214 




003233 


prog 


0046 


86B-860 




003234 




003239 


prog 


0066 


861-861 




0B323R 




003249 


prog 


006C 


862-863 




003246 




00324F 


prog 


007C 


864-864 




00 3250 




00325D 


prog 


0082 


865-868 




00325E 




00326F 


prog 


0090 


869-872 




003270 




003283 


prog 


0082 


873-875 




003284 




003289 


prog 


00B6 


876-877 




003280 






prog 


00EIL 


878-894 




00323R 




0032B5 


prog 


00CC 


895-895 




0032B6 




0032CD 


prog 


00E8 


896-899 




0032CE 




0032D3 


prog 


0100 


8100-8188 




0032D4 




0032D5 


prog 


0106 
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To display a symbol's parent symbol 

• When displaying symbols, position the mouse pointer over the symbol, press and 
hold the select mouse button, and choose Display Parent Symbols from the popup 
menu. 



Examples 



View the parent 
symbol associated 
with the highlighted 
symbol by choosing 
this menu item. 







Hewlett Packar d Emulator/Analyzer : emB8302 (m68302) 




J 


File Display 


Modify Execution Breakpoints Trace Settings 


Help 


Action keys: 


< Demo > || DispSrc() | Trace () | Run 


J |^Step^Soiurce^ 






Your Key > | 


Make [iDisp Src Prev |RunXferto( ) | Break 


|| Step Asm 




Ojma.n 




| Recall | 



Symbols in update_sys(modu le) . save_poi nts( procedure) 
Procedure special symbols 

Procedure special name Address range Segment 

ENTRY BB34EB prog 

EXIT 0035CC prog 



Local Symbols Display 



Display Local Symbols 



Display Parent Symbols 



Cut Full Symbol Name 



Edit File Defining Symbol 



Offset 
IJ31H 
03FE 



STATUS: 



H68302 — Running user program Emulation trace halted 
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To copy-and-paste a full symbol name to the 
entry buffer 

• When displaying symbols, position the mouse pointer over the symbol, press and 
hold the select mouse button, and choose Cut Full Symbol Name from the popup 
menu. 

Once the full symbol name is in the entry buffer, you can use it with pulldown 
menu items or paste it to the command line area. 

By cutting the full symbol name, you get the complete names of symbols that have 
been truncated. Also, you are guaranteed of specifying the proper scope of the 
symbol. 



Examples 



Copy the full name 
of the highlighted 
symbol to the entry 
buffer by choosing 
this menu item. 







Hewlett Packar d Emulator/Analyzer: emB8302 (mB8302) 






J 


File Display 


Modify Execution Breakpoints Trace Settings 




Help 


Action keys: 


<Demo> || DispSrcQ [1 Trace () \ Run 


| Step Source 




| < Your Key > | 


Make [|Disp Src Prev||Run Xferto ( )|| Break 


1 Step Asm [ 




( ):| U pd at e_ Sys(m od U le,. Sa v e . P o 1 n, 5(pr oce dur e ) 


Recall ( 



Symbols in update_sys(rnodu le) 
Procedure symbols 

Procedure name 

get_targets 
graph_data 
read conditions 



Address range Segment 

0B323R - 003323 prog 
0035D4 - 003680 prog 
0B332R - 0033C3 prog 




Local Symbols Display 



Pi lename symbo 1 
Fi lename 
update_sys. c 



Display Local Symbols 
Display Parent Symbols 



Cut Full Symbol 



Edit File Defining Symbol 



prog 
p r u q 
prog 



STATUS: cms: update_sys 

i : 



Offset 
00CC 
0406 
015C 

0202 
0006 
023R 
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Using Context Commands 

The commands in this section display and control the directory and symbol 
contexts for the interface. 

Directory context. The current directory context is the directory accessed by all 
system references for files — primarily load, store, and copy commands — if no 
explicit directory is mentioned. Unless you have changed directories since 
beginning the emulation session, the current directory context is that of the 
directory from which you started the interface. 

Symbol context. The emulator/analyzer interface and the Symbol Retrieval 
Utilities (SRU) together support a current working symbol context. The current 
working symbol represents an enclosing scope for local symbols. If symbols have 
not been loaded into the interface, you cannot display or change the symbol context. 

This section shows you how to: 

• Display the current directory and symbol context. 

• Change the directory context. 

• Change the symbol context. 
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To display the current directory and symbol 
context 



• Choose Display— ^Context. 



• Using the command line, enter the pwd and pws commands. 



The current directory and working symbol contexts are displayed, and also the 
name of the last executable file from which symbols were loaded. 



Example 



Directory context. 

Executable from 
which symbols were 
last loaded. 

Symbol context. 




|Emulator/Analyzer: Current Context! 



Directory: /users/guest/demo/debug_env/hp64746 
Symbol File: /users/guest/demo/debug _env/hp64746/ecs.x 
Symbol Scope: update_sys 



Done 



To change the directory context 

• Choose File— ^Context— ^Directory and use the dialog box to select a new directory. 

• Using the command line, enter the cd <directory> command. 

The Directory Selection dialog box contains a list of directories accessed during the 
emulation session as well as any predefined directories present at interface startup. 
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You can predefine directories and set the maximum number of entries for the 
Directory Selection dialog box by setting X resources (see the "Setting X 
Resources" chapter). 



To change the current working symbol context 

• Choose File— ^Context— ^Symbols and use the dialog box to select the new 
working symbol context. 

• Using the command line, enter the cws <symbol_context> command. (Because 
cws is a hidden command and doesn't appear on a softkey label, you have to type it 
in.) 

You can predefine symbol contexts and set the maximum number of entries for the 
Symbol Scope Selection dialog box by setting X resources (see the "Setting X 
Resources" chapter). 

Displaying local symbols or displaying memory in mnemonic format causes the 
working symbol context to change as well. The new context will be that of the 
local symbols or memory locations displayed. 
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Executing User Programs 

You can use the emulator to ran programs, break program execution into the 
monitor, step through the program by high-level source lines or by assembly 
language instructions, and reset the emulation processor. 

When displaying memory in mnemonic format, a highlighted bar shows the current 
program counter address. When you step, the mnemonic memory display is 
updated to highlight the new program counter address. 

When displaying resisters, the register display is updated to show you the contents 
of the registers after each step. 

You can open multiple interface windows to display memory in mnemonic format 
and registers at the same time. Both windows are updated after stepping. 

This section describes how to: 

• Start the emulator running the user program. 

• Stop (break from) user program execution. 

• Step through user programs. 

• Reset the emulation processor. 



To run programs from the current PC 

• Choose Execution— >Run— >from PC. 

• Using the command line, enter the run command. 

When the emulator is executing the user program, the message "Running user 
program" is displayed on the status line. 
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To run programs from an address 

• Position the mouse pointer in the entry buffer and enter the address you want to run 
from; then, choose Execution— >Run— >from (). 

• Using the command line, enter the run from <address> command. 

Examples To run from address 920H: 

run from 92 Oh <RETURN> 



To run programs from the transfer address 

• Choose Execution— >Run— >from Transfer Address. 

• Using the command line, enter the run from transfer_address command. 

Most software development tools allow you to specify a starting or entry address 
for program execution. That address is included with the absolute file's symbolic 
information and is known by the interface as the transfer address. 



To run programs from reset 

• Choose Execution— >Run— >from Reset. 

• Using the command line, enter the run from reset command. 

When you run from reset, the emulator drives the target reset line and begins 
executing from the contents of exception vector 0 (this will occur within a few 
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cycles of the /RESET signal). When the target system /RESET line becomes active 
and then inactive, the 68302 registers are initialized to their reset values. 



To run programs until an address 

• When displaying memory in mnemonic format, position the mouse pointer over the 
line that you want to run until; then press and hold the select mouse button and 
choose Run Until from the popup menu. 

• Position the mouse pointer in the entry buffer and enter the address you want to run 
from; then, choose Execution— >Run— mntil (). 

• Using the command line, enter the run until <address> command. 

When you run until an address, a software breakpoint is set at the address and the 
program is run from the current program counter. 

When using the command line, you can combine the various types of run 
commands; for example, you can run from the transfer address until another 
address. 



Examples To run from the transfer address until the address of the global symbol main: 

run from trans fer_address until address main <RETURN> 
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To stop (break from) user program execution 

• Choose Execution— >Break. 

• Using the command line, enter the break command. 

This command generates a break to the background monitor. 

Software breakpoints and the run until command allow you to stop execution at 
particular points in the user program. 

Examples To break emulator execution from the user program to the monitor: 

break <RETURN> 



To step high-level source lines 

• Choose Execution— >Step Source and select one of the items from the cascade 
menu. 

• Using the command line, enter the step source command. 

When stepping through instructions associated with source lines, execution can 
remain in a loop and the message "Stepping source line 1; Next PC: <address>" is 
displayed on the status line. In this situation you can abort the step command by 
pressing <CTRL>c. 
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Examples To step through instructions associated with the high-level source lines at the 

current program counter: 

step source <RETURN> 

To step through instructions associated with high-level source lines at address 
"main": 

step source from main <RETURN> 



To step assembly-level instructions 

• Choose Execution— >Step Instruction and select one of the items from the cascade 
menu. 

• Using the command line, enter the step command. 

The step command allows you to step through program execution an instruction or 
a number of instructions at a time. Also, you can step from the current program 
counter or from a specific address. 



Examples To step one instruction from the current program counter: 

step <RETURN> 

To step a number of instructions from the current program counter: 
step 8 <RETURN> 

To step a number of instructions from a specified address: 
step 16 from 92 Oh <RETURN> 
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To reset the emulation processor 

• Choose Execution— >Reset. 

• Using the command line, enter the reset command. 

The reset command causes the processor to be held in a reset state until a break, 
run, or step command is entered. A CMB execute signal will also cause the 
emulator to run if reset. 
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Using Software Breakpoints 

Software breakpoints provide a way to accurately stop the execution of your 
program at selected locations. 



Note Version A.04.00 or greater of the HP 64700 system firmware provides support for 

permanent as well as temporary breakpoints. If your version of HP 64700 system 
firmware is less than A.04.00, only temporary breakpoints are supported. 



Software breakpoints are implemented in the 68302 emulator by replacing opcodes 
with TRAP instructions. You can configure the emulator to use one of 16 different 
TRAP instructions for software breakpoints. The default emulator configuration 
specifies that the TRAP #0FH is used for software breakpoints. 

In order to successfully set a software breakpoint, the emulator must be able to 
write to the memory location specified. Therefore, software breakpoints cannot be 
set in target memory while the emulator is reset, and they can never be set in target 
ROM. (You can, however, copy target ROM to emulation memory by storing the 
contents of target ROM to an absolute file, re-mapping the range as emulation 
RAM, and loading the absolute file.) 

When you set a software breakpoint, the emulator replaces the opcode at the 
address specified with the TRAP instruction. When the emulator detects a read 
from the appropriate vector table location (TRAP instruction has executed in the 
user program), execution breaks to the monitor. 

If the TRAP was generated by a software breakpoint, a message containing the 
address of the breakpoint is displayed on the status line, and, if the breakpoint is 
temporary, the original opcode is restored in the user program. If the breakpoint is 
permanent, it remains active. A subsequent run or step command will execute 
from the breakpoint address. 

If the TRAP was not inserted as the result of a modify softwarejbreakpoints set 
command (in other words, it is part of the user program), the "Undefined software 
breakpoint" message is displayed on the status line. To continue with program 
execution, you must run or step from the user program's TRAP instruction vector 
address. 

Another way to break user program execution at a certain point is to break on the 
analyzer trigger. 



200 



Chapter 6: Using the Emulator 
Using Software Breakpoints 



CAUTION Software breakpoints should not be set, cleared, enabled, or disabled while the 

emulator is running user code. If any of these commands are entered while the 
emulator is running user code, and the emulator is executing code in the area where 
the breakpoint is being modified, program execution may be unreliable. 



All read accesses to the software breakpoint TRAP vector location will cause 
the emulator to break into background. Only the read associated with the TRAP 
instruction will cause a proper transfer to monitor. All other accesses will result in 
undefined execution. Therefore, if software breakpoints are enabled, the TRAP 
vector should not be accessed by any instruction other than a TRAP. Note that this 
includes boot-up code that attempts to perform a checksum over the vector table 
area. The status of the emulator may become undefined, and the monitor 
program may become unusable. 

This section shows you how to: 

• Display the breakpoints list. 

• Enable/disable breakpoints. 

• Set a permanent breakpoint. 

• Set a temporary breakpoint. 

• Set all breakpoints. 

• Deactivate a breakpoint. 

• Re-activate a breakpoint. 

• Clear a breakpoint. 

• Clear all breakpoints. 



201 



Chapter 6: Using the Emulator 
Using Software Breakpoints 



To display the breakpoints list 

• Choose Display— ^Breakpoints or Breakpoints— ^Display. 

• Using the command line, enter the display softwarejbreakpoints command. 

The breakpoints display shows the address and status of each breakpoint currently 
defined. If symbolic addresses are turned on (when setting the display modes), the 
symbolic label associated with a breakpoint is also displayed. Also, the breakpoints 
display shows whether the breakpoint feature is enabled or disabled. 



Software breakpoints :enabled 
address label 






status 


L1L10FD2 


mai n(modu le) 


"mai n. c" : 


line 96 


temporary 


000FOC 


mai n(modu le) . 


"mai n. c" : 


line 98 


pending 


00BFE4 


mai n(modu le) 


"mai n. c" : 


line 102 


permanent 


00103E @sp 


mai nCmodu le) 


"mai n. c" : 


line 107 


i nact i vated 



The status of a breakpoint can be: 

temporary Which means the temporary breakpoint has been set but not 

encountered during program execution. These breakpoints are 
removed when the breakpoint is encountered. 

pending Which means the temporary breakpoint has been set but not 

encountered during program execution. These breakpoints are 
inactivated when the breakpoint is encountered. 



permanent 



Which means the permanent breakpoint is active. 



inactivated Which means the breakpoint has been inactivated somehow. 

Temporary breakpoints are inactivated when they are 
encountered during program execution. Both temporary and 
permanent breakpoints may be inactivated using the breakpoints 
display popup menu. 

In the breakpoints display, a popup menu is available. You can set, inactivate, or 
clear breakpoints as well as enable or disable the breakpoints feature from the 
popup menu. 
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To enable/disable breakpoints 

• Choose the Breakpoints— ^Enable toggle. 

• When displaying the breakpoint list, press and hold the select mouse button and 
then choose Enable/Disable Software Breakpoints from the popup menu. 

• Using the command line, enter the modify softwarejbreakpoints enable or 
modify softwarejbreakpoints disable command. 

The breakpoints feature must be enabled before you can set, inactivate, or clear 
breakpoints. 

If breakpoints were set when the feature was disabled, they are "inactivated" when 
the feature is re-enabled, and you must set them again. 

The emulator/analyzer interface will enable software breakpoints whenever the 
XEnv_68k_except symbol is present in the symbol data base. 

The run-time library provided with the 68000 C Cross Compiler uses software 
breakpoints to interrupt program execution when exceptions (for example, divide 
by zero) are encountered. If software breakpoints are disabled, exception 
processing may result in "access to guarded memory" errors and/or other 
unpredictable behavior. To prevent this, a special global symbol, 
XEnv_68k_except, is included in the library. 

When the XEnv_68k_except symbol is present, the 68302 emulator writes a value 
to this location. The value tells the run-time library which TRAP instruction to use 
to perform a software break. 
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Examples To enable software breakpoints using the breakpoints display popup menu: 



Bring up menu and 
choose this item to 
change states. 



Hewlett Packard Emulator/Analyzer: em6B302 (m68302) 



□ 



File Display Modify Execution Breakpoints Trace Settings 



Help 



Action keys: | < Demo > [| DispSrc(3~|| Trace () [| Run j| Step Source"] 
|<YourKey~rj| Mak e [ |Disp Src Prevpun Xferto ( )[| Break [ | Step Asm [ 



( ): update_sys(module) . save_points(procedure) 



Recall 



Software breakpoints : disabled 
address Lahe_l 



status 



002BCE Esp 

002BB8 @sp 

002BE0 @sp 

002C0R Esp 



mai n(modu le) . main. c 
main(module)."main.c" 
mai n( module) . "main, c" 
mai n(modu le) . "main. c" 



line 36 inactivated 

line 98 inactivated 

line 102 inactivated 

line 107 inactivated 



STATUS: 



Choose Action for Highlighted Line 



Set/lnactlvate Breakpoint 
Clear (delete) Breakpoint 



Choose Action for All Breakpoints 



Enable/Disable Software Breakpoints 



Set All Breakpoints 
Clear (delete) All Breakpoints 

HG8302 — Running in monitor Software break: UUlVhoURsp 
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To set a permanent breakpoint 

• When displaying memory in mnemonic format, position the mouse pointer over the 
program line at which you wish to set the breakpoint and click the select mouse 
button. Or, press and hold the select mouse button and choose Set/Clear Software 
Breakpoint from the popup menu. 

• Place an absolute or symbolic address in the entry buffer; then, choose 
Breakpoints— ^Permanent () 

• Using the command line, enter the modify softwarejbreakpoints set <address> 
permanent command. 

Permanent breakpoints are available if your version of HP 64700 system firmware 
is A.04.00 or greater. 

The breakpoints feature must be enabled before individual breakpoints can be set. 

Note that software breakpoints only stop program execution at memory locations 
which contain instruction opcodes (not operands or data). 

When displaying memory in mnemonic format, asterisks (*) appear next to 
breakpoint addresses. An asterisk shows the breakpoint is active. Also, if 
assembly level code is being displayed, the disassembled instruction mnemonic at 
the breakpoint address will show the breakpoint instruction. 
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Examples To set permanent breakpoints using the mnemonic memory display popup menu: 



Click this line to set a 
breakpoint. 

Click this line to 
clear a breakpoint. 
(Asterisks mark set 
breakpoints.) 



Bring up menu and 
choose this item to 
set (or clear) a 
breakpoint on the 
highlighted line. 



Action keys: | < Demo > || Disp Src ( 3~[ | Trace () || Run [| Step Source 




Hewlett Packard Emulator/Analyzer: em6B3[]2 (mB8302) 



□ 



File Display Modify Execution Breakpoints Trace Settings 



Help 



VourKey»|| Make [ |Disp Src Prev[|Run Xfer to ( )| | Break [ | StepAs m" 

jRecali 



: @sp :mnemonic 
5 LaheJ 



: f i le = main(rnodule) . 
daia 



extern void update_system( ) ; 
extern void i nterrupt_sim( ) ; 
extern void do_sort(); 

main( ) 
£ 

i ni t_systern( ) ; 
proc_spec_i ni t ( ) ; 



whi le (true) 
{ 

num_checks++; 
i nterrupt_sim(&nur 
if (graph) 

graph_data( ) 
proc_speci f ic( ) 



/* update system variables */ 
/* simulate an i nterrupt */ 
/* sets up ascii array and calls! 



STATUS: 



M68302 — Stepping complete 



Choose Action for Highlighted Line 



Set/Clear Software Breakpoint 



Edit Source 



Run Until 



Trace After 



To set a temporary breakpoint 

• Place an absolute or symbolic address in the entry buffer; then, choose 
Breakpoints— >Temporary () (or Breakpoints— >Set () if your version of 
HP 64700 system firmware is less than A.04.00). 

• Using the command line, enter the modify softwarejbreakpoints set <address> 
temporary or modify softwarejbreakpoints set <address> command. 

The breakpoints feature must be enabled before individual breakpoints can be set. 
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Note that software breakpoints only stop program execution at memory locations 
which contain instruction opcodes (not operands or data). 

When displaying memory in mnemonic format, asterisks (*) appear next to 
breakpoint addresses. An asterisk shows the breakpoint is active. Also, if 
assembly level code is being displayed, the disassembled instruction mnemonic at 
the breakpoint address will show the breakpoint instruction. 



To set all breakpoints 

• When displaying the breakpoint list, position the mouse pointer within the 
breakpoints display screen, press and hold the select mouse button, and choose Set 
All Breakpoints from the popup menu. 

• Choose Breakpoints— >Set All. 

• Using the command line, enter the modify softwarejbreakpoints set command. 
Breakpoints must be enabled before being set. 



To deactivate a breakpoint 

• When displaying breakpoints, position the mouse pointer over the line displaying 
the active breakpoint and click the select mouse button. Or, press and hold the 
select mouse button and choose Set/Inactivate Breakpoint from the popup menu. 

A deactivated breakpoint remains in the breakpoint list and can be re-activated 
later. Deactivating a breakpoint is different than clearing a breakpoint because a 
cleared breakpoint is removed from the breakpoints list. 
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To re-activate a breakpoint 

• When displaying breakpoints, position the mouse pointer over the line displaying 
the inactivated breakpoint and click the select mouse button. Or, press and hold the 
select mouse button and choose Set/Inactivate Breakpoint from the popup menu. 

The "inactivated" breakpoint either becomes "temporary" (or "pending") if it was 
set as a temporary breakpoint or "permanent" if it was set as a permanent 
breakpoint. 
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Examples 



To re-activate breakpoints using the breakpoints display popup menu: 



Change status with a 
mouse click on this 
line (menu and 
highlight do not 
appear). 

Choose this menu 
item to change the 
state of the 
highlighted 
breakpoint. 



Hewlett Packard Emulator/Analyzer: em68302 (m68302) 



□ 



File Display Modify Execution Breakpoints Trace Settings 



Help 



Action keys: 



: Your Key = 



Demo > || Disp Src ( ) [I Trace () M Run 
|Disp Src Pre v[ |Run Xferto( )[ | Break 



Make 



Step Asm 



(): 



Recall 



Software breakpoints : enabled 
address LaiieJ 



002BCE @sp 



■nain(rnodule). "mai 
main(module). "ma in. c" 



1 i ne 
1 l ne 



96 inactivated 





Choose Action for Highlighted Line 




Set/Inactivate Breakpoint 


Clear (delete) Breakpoint 


Choose Action for All Breakpoints 




Enable/Disable Software Breakpoints 






Set All Breakpoints 






Clear (delete) All Breakpoints 





STATUS: 



HG8302 — Stepping comp lete 



Emulation trace halted 
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To clear a breakpoint 

• When displaying memory in mnemonic format, position the mouse pointer over the 
program line at which you wish to clear a currently set breakpoint (notice the 
asterisk at the left of the line) and click the select mouse button. Or, press and hold 
the select mouse button and choose Set/Clear Software Breakpoint from the 
popup menu. 

• When displaying breakpoints, position the mouse pointer over the line displaying 
the breakpoint you wish to clear, press and hold the select mouse button, and 
choose Clear (delete) Breakpoint from the popup menu. 

• Place an absolute or symbolic address in the entry buffer; then choose 
Breakpoints— >Clear (). 

• Using the command line, enter the modify softwarejbreakpoints clear <address> 

command. 

When you clear a breakpoint, it is removed from the breakpoints list. 
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Examples 



To clear a software breakpoint using the breakpoints display popup menu: 



Bring up the menu 
and choose this item 
to clear the 
highlighted 
breakpoint. 



Hewlett Packard Emulator/Analyzer: em68302 (mB8302) 



□ 



File Display Modify Execution Breakpoints Trace Settings 



Help 



Action keys: | < Demo > [| DispSrcQ || Trace () || Run || Step Source 



= Your Key r[| Make [|Disp Src Prev[[Run Xferto (~)|| Break [| Step Asm 



(): 



Recall 



Software breakpoints : enabled 
address label 



002BCE Bsp 
002BD8 @sp 



mai n(modu le) . "mai n. c" : 
mai n(modu le) . "mai n. c" : 



line 36 inactivated 
line 38 pending 



Choose Action for Highlighted Line 



Set/Inactivate Breakpoint 



Clear (delete) Breakpoint 



Choose Action for All Breakpoints 



Enable/Disable Software Breakpoints 

Set All Breakpoints 

Clear (delete) All Breakpoints 



STATUS: 



H68302 — Stepping complete 



Emulation trace halted 
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To clear all breakpoints 

• When displaying breakpoints, position the mouse pointer within the Breakpoints 
Display screen, press and hold the select mouse button, and choose Clear (delete) 
All Breakpoints from the popup menu. 

• Choose Breakpoints— >Clear All. 

• Using the command line, enter the modify softwarejbreakpoints clear command. 
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Displaying and Modifying Registers 

You can display and modify the contents of emulation processor registers. Most 
emulators have at least a BASIC class of registers. Some emulators have additional 
register classes whose register contents can be displayed and modified. Consult 
your emulator-specific Softkey Interface documentation for a definition of the 
register classes. 

This section shows you how to: 

• Display register contents. 

• Modify register contents. 

This section describes tasks related to displaying and modifying emulation 
processor registers. 

You can display the contents of an individual register or of all the registers. The 
register classes and names are listed in the following table. 



<REGCLASS> 


<REGNAME> 


Description 


basic (or no register 


pc 


Program Counter 


class specified) 


usp 


User Stack Pointer 




ssp 


Supervisor Stack Pointer 




St 


Status Register 




bar 


Base Address Register 




scr 


System Control Register 




d0-d7 


Data Registers 




a0-a7 


Address Registers 


302 


bar 


Base Address Register 




scr 


System Control Register 




cr 


Command Register 




spmode 


SCP, SMC Mode and Clock Control Register 




simask 


Serial Interface Mask Register 




simode 


Serial Interface Mode Register 
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<REGCLASS> 


<REGNAME> 


Description 


idma 


rcr 


Function Code Register 




cmr 


^.iiaiuiei ivioue ive^isiei 




sapr 


Source Address Pointer 




dapr 


Destination Address Pointer 




bcr 


Byte Count Register 




csr 


Channel Status Register 


interrupt 


gimr 


Global Interrupt Mode Register 




ipr 


imeiiupL renuing ivegisier 




imr 


Interrupt Mask Register 




isr 


In-Service Register 


pio 


pcant 


Port A Control Register 




paddr 


Port A Data Direction Register 




padat 


Port A Data Register 




pbcnt 


Port B Control Register 




pbddr 


Port B Data Direction Register 




pbdat 


r oil r> i-'dLd jvegisiei 


chip_sel 


brO 


Base Register 0 




orO 


Option Register 0 




brl 


Base Register 1 




orl 


Option Register 1 




br2 


Base Register 2 




or2 


Option Register 2 




br3 


Base Register 3 




or3 


Option Register 3 


tmr 


tmrl 


Timer Unit 1 Mode Register 




trrl 


Timer Unit 1 Reference Register 




tcrl 


Timer Unit 1 Capture Register 




tcnl 


Timer Unit 1 Counter 




terl 


Timer Unit 1 Event Register 




wrr 


Watchdog Reference Register 




wen 


Watchdog Counter 




tmr2 


Timer Unit 1 Mode Register 




trr2 


Timer Unit 1 Reference Register 




tcr2 


Timer Unit 1 Capture Register 




tcn2 


Timer Unit 1 Counter 




ter2 


Timer Unit 1 Event Register 
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<REGCLASS> 


<REGNAME> 


Description 


sccl 


sconl 


SCCl Configuration Register 




scml 


SCCl Mode Register 




dsrl 


SCCl Data Synchronization Register 




scce 1 


Pvpnt Rpuktpr 
ov v i dvciiL rvcyi^i-ci 




sccml 


SCCl Mask Register 




sccsl 


SCCl Status Register 


scc2 


scon2 


SCC2 Configuration Register 




scm2 


SCC2 Mode Register 




dsr2 


SCC2 Data Synchronization Register 




scce2 


ov. a_ z liveiiL ivegisiei 




sccm2 


SCC2 Mask Register 




sccs2 


SCC2 Status Register 


scc3 


scon3 


SCC3 Configuration Register 




scm3 


SCC3 Mode Register 




dsr3 


ovw LJ(X\.(X o jii^iiiwiiiZjtiLivjii rvt-gjiaid 




scce3 


SCC3 Event Register 




sccm3 


SCC3 Mask Register 




sccs3 


SCC3 Status Register 


sec 


(see the registers 


Serial Communications Controller Registers 




listed for the sccl, 






scc2, and scc3 






register classes 






above.) 
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To display register contents 

• Choose Display— ^Registers. 

• Using the command line, enter the display registers command. 

When displaying registers, you can display classes of registers and individual 
registers. 
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To modify register contents 

• Choose Modify— ^Registers... and use the dialog box to name the register and 
specify its value. 



Clicking the "Recall" pushbutton 
lets you select register names and 
values from predefined or previously 
specified entries. 



Placing the mouse pointer in the text 
entry area lets you type in the register 
name and value. 



To define the type of value, press 
and hold the command select mouse 
button and drag the mouse to select 
the value type. 

Clicking this checkbox causes the 
current value of the named register to 
be placed in the "Value" text entry 
area. 



Clicking this button modifies the 
register to the value specified and 
closes the dialog box. 



I iiiiil.iiiii/'An.ily.-i.| Mmlily lii'i|isterjjfl| 



Modify Register- 
Name 



Value 



Recall ! 



Recall ; 



/□ Read Current Register Value 




Clicking this button modifies 
the register to the value 
specified and leaves the dialog 
box open. 



Clicking this button cancels 
modification and closes the 
dialog box. 



• Using the command line, enter the modify register <register> to <value> 

command. 
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Displaying and Modifying Memory 

You can display and modify the contents of memory in hexadecimal formats and in 
real number formats. You can also display the contents of memory in assembly 
language mnemonic format. 

This section shows you how to: 

• Display memory. 

• Display memory in mnemonic format. 

• Display memory in mnemonic format at the current PC. 

• Return to the previous mnemonic display. 

• Display memory in hexadecimal format. 

• Display memory in real number format. 

• Display memory at an address. 

• Display memory repetitively. 

• Modify memory. 

• Modify memory at an address. 



To display memory 

• Choose Display— ^Memory. 

This command either re-displays memory in the format specified by the last 
memory display command, or, if no previous command has been executed, displays 
memory as hexadecimal bytes beginning at address zero. 
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To display memory in mnemonic format 

• To display memory at a particular address, place an absolute or symbolic address in 
the entry buffer; then, choose Display— ^Memory— ^Mnemonic (), or, using the 
command line, enter the display memory <address> mnemonic command. 

• To display memory at the current program counter address, choose 
Display— ^Memory— ^Mnemonic at PC, or, using the command line, enter the 
display memory mnemonic at_pc command. 

A highlighted bar shows the location of the current program counter address. This 
allows you to view the program counter while stepping through user program 
execution. 

Whether source lines, assembly language instructions, or symbols are included in 
the display depends on the modes you choose with the 

Settings— ^Source/Symbols Modes or Settings— ^Display Modes pulldown menu 
items. See the "Changing the Interface Settings" section. 

If symbols are loaded into the interface, the default is to display source only. 



To return to the previous mnemonic display 

• Choose Display— ^Memory— ^Mnemonic Previous. 

• Using the command line, enter the display memory mnemonic previous_display 

command. 

This command is useful for quickly returning to the previous mnemonic memory 
display. 

For example, suppose you are stepping source lines and you step into a function 
that you would like to step over. You can return to the previous mnemonic 
memory display, set a breakpoint at the line following the function call, and run the 
program from the current program counter. 
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To display memory in hexadecimal format 

• Place an absolute or symbolic address in the entry buffer; then, choose 
Display— ^Memory— >Hex () and select the size from the cascade menu. 

• Using the command line, enter the display memory <address> blocked <size> 

command. 

This command displays memory as hexadecimal values beginning at the address in 
the entry buffer. 



Examples To display memory in absolute word format: 

display memory ascii_old_data absolute words <RETURN> 



Memory : C 

a HHrR :=.:=. 


sp :words : absolute : update 
label data : hex 




0077 IE 


ascii old d 2020 




007720 


2020 




007722 


2034 


4 


007724 


3300 


3. 


007726 


2350 


8P 


007728 


6173 


as 


00772H 


2020 




00772C 


3400 


4. 


00772E 


2020 




007730 


3733 


73 


007732 


2E33 


.3 


007734 


3400 


4. 


007736 


2353 


8S 


007738 


7763 


wi 


007738 


2020 




00773C 


3100 


1. 


00773E 


004C 


. L 
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To display memory in blocked byte format: 

display memory ascii_old_data blocked bytes <RETURN> 



Memory : 1 
address 




Dytes 


b locked 
:h 


: u p dare 

ex 














as 


. i 






00771E- 


-25 


20 


20 


20 


20 


20 


34 


33 


00 












-4 


3 . 


007726- 


-2D 


23 


50 


61 


73 


20 


20 


34 


00 


tt 


p 


a 


s 






4 . 


00772E- 


-35 


20 


20 


37 


33 


2E 


33 


34 


00 






7 


3 




3 


4 . 


007736- 


■3D 


23 


53 


77 


63 


20 


20 


31 


00 


« 


5 


w 


i 






1 . 


0B773E 


-45 


00 


4C 
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To display memory in real number format 

• Place an absolute or symbolic address in the entry buffer; then, choose 
Display— ^Memory— >Real () and select the size from the cascade menu. 

• Using the command line, enter the display memory <address> real <size> 

command. 

Displays memory as a list of real number values beginning at the address in the 
entry buffer. Short means four byte real numbers and long means eight byte real 
numbers. 
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Examples To display memory in 64-bit real number format: 

display memory real long <RETURN> 



Memory : Ssp : long real 


: update 


address label 


data :real 


00771E ascii old d 


6.01347001874390E-154 


007726 


1. 375540801 17400E-138 


R8772E 


6.04708270983062E-154 


007736 


1.63466481035065E-138 


00773E 


3. 145200638 16799E-307 


007746 


1.07615524484637E+060 


00774E 


1.59148924067205E+016 


007756 


2. 348288301 12763E+007 


00775E 


1.59148924067205E+016 


007766 


1.59148924067205E+016 


00776E 


1.59148924067205E+016 


007776 


1.59148924067205E+016 


00777E 


1.59148924067205E+016 


007786 


1.59148924067205E+016 


00778E 


1.59148924067205E+016 


007796 


1.59148924067205E+016 


00779E 


1.59148924B67205E+016 



To display memory at an address 

• Place an absolute or symbolic address in the entry buffer; then, choose 
Display— ^Memory— >At (). 

This command displays memory in the same format as that of the last memory 
display command. If no previous command has been issued, memory is displayed 
as hexadecimal bytes. 
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To display memory repetitively 

• Choose Display— ^Memory— ^Repetitively. 

• Using the command line, enter the display memory repetitively command. 

The memory display is constantly updated. The format is specified by the last 
memory display command. 

This command is ignored if the last memory display command was a mnemonic 
display. 



To modify memory 

• Choose Modify— ^Memory and complete the command using the command line. 

• To modify memory at a particular address, place an absolute or symbolic address in 
the entry buffer; then, choose Modify— ^Memory at () and complete the command 
using the command line. 

• Using the command line, enter the modify memory command. 

You can modify the contents of one memory location or a range of memory 
locations. Options allow you to modify memory in byte, short, word, and real 
number formats. 
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Displaying Data Values 

The data values display lets you view the contents of memory as data types. You 
can display data values in the following formats: 

bytes 

8-bit integers 
unsigned 8-bit integers 
chars 
words 

16-bit integers 
unsigned 16-bit integers 
long words 
32-bit integers 
unsigned 32-bit integers 

This section shows you how to: 

• Display data values. 

• Clear the data values display and add a new item. 

• Add item to the data values display. 



To display data values 

• Choose Display— >Data Values. 

• Using the command line, enter the display data command. 

Items must be added to the data values display before you can use this command. 

The data display shows the values of simple data types in the user program. When 
the display mode setting turns ON symbols, a label column that shows symbol 
values is added to the data display. 

Step commands and commands that cause the emulator to enter the monitor (for 
example, encountering a breakpoint) cause the data values screen to be updated. 
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To clear the data values display and add a new 
item 

• Place an absolute or symbolic address in the entry buffer; then, choose 
Display— >Data Values— >New () and select the data type from the cascade menu. 

• Using the command line, enter the display data <address> command. 



To add items to the data values display 

• Place an absolute or symbolic address in the entry buffer; then, choose 
Display— >Data Values— >Add () and select the data type from the cascade menu. 

• Using the command line, enter the display data , <address> command. 
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Changing the Interface Settings 

This section shows you how to: 

• Set the source/symbol modes. 

• Set the display modes. 



To set the source/symbol modes 

• To display assembly language mnemonics with absolute addresses, choose 
Settings— ^Source/Symbol Modes— ^Absolute, or, using the command line, enter 
the set source off symbols off command. 

• To display assembly language mnemonics with absolute addresses replaced by 
global and local symbols where possible, choose Settings— ^Source/Symbol 
Modes— ^Symbols, or, using the command line, enter the set source off symbols 
on command. 

• To display assembly language mnemonics intermixed with high-level source lines, 
choose Settings— ^Source/Symbol Modes— ^Source Mixed, or, using the command 
line, enter the set source on symbols on command. 

• To display only high-level source lines, choose Settings— ^Source/Symbol 
Modes— ^Source Only, or, using the command line, enter the set source only 
symbols on command. 

The source/symbol modes affect mnemonic memory displays and trace displays. 

Each display mode cascade menu choice is a toggle. Choosing one of these items 
causes it to be the only one active and toggles all others off. Provided that symbols 
were loaded, the interface defaults to: 

• Source only for mnemonic memory displays. 

• Source mixed for trace listing displays. 
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To set the display modes 



• Choose Settings— ^Display Modes... to open the display modes dialog box. 



Press and hold the select 
mouse button and drag the 
mouse to select "Source Only" 
"Source Mixed", or "Off". 



Clicking toggles whether 
symbolic information is 
displayed. 



Move the mouse pointer to the 
text entry area and type in the 
value. Descriptions of the 
modes follow. 



Clicking toggles auto update 
settings. 




Clicking this checkbox 
changes all display mode 
settings to their defaults. 



Clicking this button saves 
your changes and closes the 
dialog box. 



Emulator/Analyzer : Display Modes 
r Source/Symbols View 



^Source j n Memory ^ourc^^ 



Source Mixed o 



Source in Trace 
Tab Expansion (2 to 15 Spaces) 
H Symbolic Addresses 




rFieldWidths- 
LabelJ 
Mnemonic Field 
Symbols in Mnemonic Field 
Source 




12 



55 



16 



Source: (60 to 255) All Others: (1 to 80) 




Auto Update 

H Memory Displays (Except Mnemonic) 
13 Memory Mnemonic Auto PC 
■I Trace Display 



□ Default All Settings 



I OK 



| Apply | Cancel 



Clicking this button saves Clicking this button cancels your 
your changes and leaves the changes and closes the dialog box. 
dialog box open. 
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Source/Symbols View 

Source in Memory specifies whether source lines are included, mixed with 
assembly code, or excluded from mnemonic memory displays. 

Source in Trace specifies whether source lines are included, mixed with stored 
states, or excluded from trace displays. 

Symbolic Addresses specifies whether symbols are included in displays. 
Tab Expansion sets the number of spaces displayed for tabs in source lines. 

Source/Symbols View 

Label Field sets the width (in characters) of the address field in the trace list or 
label (symbols) field in any of the other displays. 

Mnemonic Field sets the width (in characters) of the mnemonic field in memory 
mnemonic, trace list, and register step mnemonic displays. It also changes the 
width of the status field in the trace list. 

Symbols in Mnemonic Field sets the maximum width of symbols in the mnemonic 
field of the trace list, memory mnemonic, and register step mnemonic displays. 

Source Lines sets the width (in characters) of the source lines in the memory 
mnemonic display. 

Auto Update 

Memory Displays toggles whether memory displays are automatically updated 
after commands that change memory contents or whether you must enter memory 
display commands to update the display. You may wish to turn off memory 
display updates, for example, when displaying memory mapped I/O. 

Trace Displays toggles whether trace displays are automatically updated when 
trace measurements complete or whether you must enter trace display commands to 
update the display. You may wish to turn off trace display updates in one 
emulator/analyzer window in order to compare the display with a new trace display 
in another emulator/analyzer window. 



228 



Chapter 6: Using the Emulator 
Using System Commands 



Using System Commands 

With the Softkey Interface system commands, you can: 

• Set UNIX environment variables while in the Softkey Interface. 

• Display the name of the emulation module. 

• Display the event log. 

• Display the error log. 



To set UNIX environment variables 

• Using the command line, enter the set <VAR> command. 

You can set UNIX shell environment variables from within the Softkey Interface 
with the set <environment_variable> = <value> command. 

Examples To set the PRINTER environment variable to "lp -s": 

set PRINTER = "lp -s" <RETURN> 

After you set an environment variable from within the Softkey Interface, you can 
verify the value of it by entering !set <RETURN>. 
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To display the name of the emulation module 

• Using the command line, enter the name_of_module command. 

While operating your emulator, you can verify the name of the emulation module. 
This is also the logical name of the emulator in the emulator device file. 



Examples To display the name of your emulation module: 

name_of_module <RETURN> 

The name of the emulation module is displayed on the status line. 



To display the event log 

• Choose Display— >E vent Log. 

• Position the mouse pointer on the status line, press and hold the select mouse 
button, and then choose Display Event Log from the popup menu. 

• Using the command line, enter the display eventjog command. 

The last 100 events that have occurred during the emulation session are displayed. 

The status of the emulator and analyzer are recorded in the event log, as well as the 
conditions that cause the status to change (for example, software breakpoints and 
trace commands). 
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To display the error log 

• Choose Display— >Error Log. 

• Position the mouse pointer on the status line, press and hold the select mouse 
button, and then choose Display Error Log from the popup menu. 

• Using the command line, enter the display errorjog command. 

The last 100 error messages that have occurred during the emulation session are 
displayed. 
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To edit files 

• Choose File— >Edit— >File and use the dialog box to specify the file name. 

• To edit a file based on an address in the entry buffer, place an address reference 
(either absolute or symbolic) in the entry buffer; then, choose File— >Edit— >\t () 
Location. 

• To edit a file based on the current program counter, choose File— >Edit— >At PC 
Location. 

• To edit a file associated with a symbol when you are displaying symbols, position 
the mouse pointer over the symbol, press and hold the select mouse button, and 
choose Edit File At Symbol from the popup menu. 

• To edit a file when displaying memory in mnemonic format, position the mouse 
pointer over the line of source where you want to begin the edit, press and hold the 
select mouse button, and choose Edit Source from the popup menu. 

When editing files at addresses, the interface determines which source file contains 
the code generated for the address and opens an edit session on the file. The 
interface will issue an error if it cannot find a source file for the address. 

The interface will choose the "vi" editor as its default editor, unless you specify 
another editor by setting an X resource. Refer to the "Setting X Resources" chapter 
for more information about setting this resource. 

You must load symbols before most commands will work because symbol 
information is needed to be able to locate the files. 
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To edit a file at a source line: 



Choosing this menu 
item brings up a 
terminal window 
with an edit session 
open on the file 
where the 
highlighted source 
line exists. — 



Hewlett Packard Emulator/Analyzer: emBB3[]2 (mB8302) 



□ 



File Display Modify Execution Breakpoints Trace Settings 



Help 



Action keys: 



Run 



|<VourKeyT|| Mak e [ |Disp Src Prevpun Xferto ( )[| Break [ | Step ~As 



Step Source 
m 



( ): save_poi nts 



Recall 



Memory : @sp :mnemonic :file = updat e_sys(modu le) . " updat e_sys. c" 



aHHrfiss 1 aha 1 



data 



262 
263 
264 
265 
266 

mt 

268 
269 
270 
271 



MflKEBHR( HR66) ; 

o ld_dat a[curr_loc] . temp = current_temp; 
o ld_dat aCcurr_loc] . humi d = current_humi d; 
curr_loc++; 



272 
273 
274 
275 
276 
277 
278 



temp_tot-0; 

for (i=8; i<NUM_0F_0LD; i++ 
temp_tot += old_data[ 



old dataCcurr loc].ave te 



hum 1 d_T rit -H ; 

for (i=B; i<NUM_0F_0LD; i++ 
humid_tot += old_data 



STATUS: 



M68302 — Stepping complete 



Choose Action for Highlighted Line 



Set/Clear Software Breakpoint 



Edit Source 



Run Until 



HFJJLD I 



Trace After 
Trace Before 
Trace About 
Trace Until 



DB - 



234 



Chapter 6: Using the Emulator 
Using System Commands 



To copy information to a file or printer 

• Choose File— >Copy, select the type of information from the cascade menu, and use 
the dialog box to select the file or printer. 

• Using the command line, enter the copy command. 
ASCII characters are copied to the file or printer. 

If you copy information to an existing file, it will be appended to the file. 
Refer to the following paragraphs for details about the different copy options. 

Display ... Copies information currently in the display area. This option is useful 
for restricting the number of lines that are copied. Also, this option is useful for 
copying the contents of register classes other than BASIC. 

Memory ... Copies the contents of a range of memory. The format is the same as 
specified in the last display memory command. For example, if you copy memory 
after displaying a range of memory in mnemonic format, the file would contain the 
mnemonic memory information. If there is no previous display memory command, 
the format used is a blocked hex byte format beginning at address zero. 

Data Values ... Copies the contents of the defined data values last displayed. An 
error occurs if you try to copy data values to a file if you have not yet displayed 
data values. 

Trace ... The most recently captured trace is copied to the file. The copied trace 
listing is formatted according to the current display mode. 

You can set the display mode with the Settings— ^Source/Symbols Modes or 
Settings— ^Display Modes pulldown menu items. See the "Changing the Interface 
Settings" section. 

Registers ... Copies the current values of the BASIC register class to a file. To 
copy the contents of the other register classes, first display the registers in that 
class, and then use the File— >Copy— ^Display ... command. 

Breakpoints ... Copies the breakpoints list. If no breakpoints are present in the 
list, only the enable/disable status is copied. 
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Status ... Copies the emulator/analyzer status display. 

Global Symbols ... Copies the global symbols. If symbols have not been 
loaded, this menu item is grayed-out and unresponsive. 

Local Symbols () ... Copies the local symbols from the symbol scope named 
(by an enclosing symbol) in the entry buffer. If symbols have not been loaded, this 
menu item is grayed-out and unresponsive. 

Pod Commands ... Copies the last 100 lines from the pod commands display. 
Error Log ... Copies the last 100 lines from the error log display. 
Event Log ... Copies the last 100 lines from event log display. 



To open a terminal emulation window 

• Choose File-^Term... 

This command opens a terminal window into the current working directory context. 
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Using Simulated I/O 

Simulated I/O is a feature of the emulator/analyzer interface that lets you use the 
same keyboard and display that you use with the interface to provide input to 
programs and display program output. 

To use simulated I/O, your programs must communicate with the simulated I/O 
control address and the buffer locations that follow it. (The Hewlett-Packard AxLS 
compilers, if your program uses I/O, automatically link with environment 
dependent routines that communicate with the simulated I/O control address and 
buffer.) 

Also, before simulated I/O can work, the emulator must be configured to enable 
polling of the simulated I/O control address and to define the control address 
location. 

This section shows you how to: 

• Display the simulated I/O screen. 

• Use simulated I/O keyboard input. 

Refer to the Simulated I/O User's Guide for complete details on how simulated I/O 
works. 



To display the simulated I/O screen 

• Choose Display— ^Simulated IO. 

Before you can display simulated I/O, polling for simulated I/O must be enabled in 
the emulator configuration. 
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Examples 
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A message tells you whether the display is open or closed. You can modify the 
configuration to enable status messages. 



To use simulated I/O keyboard input 

• To begin using simulated I/O input, choose Settings— ^Simulated IO Keyboard. 

• To end simulated I/O and return to using the interface, use the suspend softkey. 

The command line entry area is used for simulated input with the keyboard. 
Therefore, if the command line is turned off, choosing this menu item with turn 
command line display back on. 

If you are planning to use even a modest amount of simulated I/O input during an 
emulation session, it might be a good idea to open another Emulator/ Analyzer 
window to be used exclusively for simulated I/O input and output. 
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Using Basis Branch Analysis 

Basis branch analysis (BBA) is provided by the HP Branch Validator product. This 
product is used to analyze the testing of your programs, create more complete test 
suites, and quantify your level of testing. 

The HP Branch Validator records branches executed in a program and generates 
reports that provide information about program execution during testing. It uses a 
special C preprocessor to add statements that write to a data array when program 
branches are taken. After running the program in the emulator (using test input), 
you can store the BBA information to a file. Then, you can generate reports based 
on the stored information. 

This section shows you how to: 

• Store BBA data to a file. 

Refer to the HP Branch Validator (BBA) User's Guide for complete details on the 
BBA product and how it works. 



To store BBA data to a file 

• Choose File— >Store— >BBA Data and use the selection dialog box to specify the 
file name. 

The default file name "bbadump.data" can be selected from the dialog box. 
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This chapter describes tasks you may wish to perform while using the emulation 
analyzer. These tasks are grouped into the following sections: 

• The basics of starting, stopping, and displaying traces. 

• Qualifying trigger and store conditions. 

• Using the sequencer. 

• Modifying trace displays. 

• Saving and restoring traces. 



Chapter 7: Using the Emulation Analyzer 
The Basics of Starting, Stopping, and Displaying Traces 



The Basics of Starting, Stopping, and Displaying 
Traces 

This section describes the basic tasks that relate to starting and stopping trace 
measurements. 

When you start a trace measurement, the analyzer begins looking at the data on the 
emulation processor's bus and control signals on each analyzer clock signal. The 
information seen on a particular clock is called a state. 

When one of these states matches the "trigger state" you specify, the analyzer stores 
states in trace memory. When trace memory is filled, the trace is said to be 
"complete." The default trigger state specification is "any state," so when you start 
a trace measurement after initializing the analyzer, the analyzer will "trigger" on the 
first state it sees and store the following states in trace memory. 

Once you start a trace measurement, you can view the progress of the measurement 
by displaying the trace status. 

In some situations, for example, when the trigger state is never found or when the 
analyzer hasn't filled trace memory, the trace measurement does not complete. In 
these situations, you can halt the trace measurement. 

Once a trace is displayed, you can use the cursor keys and other keys to position the 
trace list on the display. To speed up the display of traces, you can reduce the 
depth of the trace list. Also, when entering trace commands, there is a special 
command that allows you to recall and modify the last trace command entered. 

This section describes how to: 

• Start trace measurements. 

• Display the trace status. 

• Stop trace measurements. 

• Display the trace. 

• Position the trace display on the screen. 

• Change the trace depth. 

• Modify the last trace command entered. 
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To start a trace measurement 

• Choose Trace— ^Everything. 

• Using the command line, enter the trace command. 

The trace command tells the analyzer to begin monitoring the states which appear 
on the trace signals. You will see a message that confirms that a trace is started. 

The default trace command (simply trace with no options) will trigger on any state, 
store all captured states. 



Examples While the emulator is running the user program, you can start the default trace 

measurement with the command: 

trace <RETURN> 

A message is displayed on the status line to show you that the "Emulation trace 
[has] started", and another message will show you when the "Emulation trace [is] 
complete". 



To display the trace status 

• Choose Display— ^Status. 

• Using the command line, enter the display status command. 

In addition to the analyzer information shown on the status line (Emulation trace 
started, Emulation trace complete, etc.), you can display complete analyzer status 
with the command below. 
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Examples To display the trace status: 

display status <RETURN> 



Status 



Emulator Status 

M683B2 — Running user program 

Trace Status 

Emulation trace complete 
Arm ignored 
Trigger in memory 
firm to trigger ? 
States 512 (512) 0. . 51 1 
Sequence term 2 
Occurrence left 1 



The first line of the emulation trace status display shows the user trace has been 
"completed"; other possibilities are that the trace is still "running" or that the trace 
has been "halted". 

The "Arm ignored" line shows that the arm condition, which can be used to qualify 
trace measurements, is ignored. Consequently, the "Arm to trigger" time is not 
meaningful and a question mark is displayed. (The "Making Coordinated 
Measurements" chapter explains arm conditions.) 

The second line of the trace status display contains information on the arm 
condition. If the analyzer is always armed, the message "Arm ignored" is 
displayed. If the analyzer is to be armed by one of the internal signals, either the 
message "Arm not received" or "Arm received" is displayed. The display indicates 
if the arm condition happened any time since the most recent trace started, even if it 
happened after the trace was halted or became complete. 

The "Arm to trigger" line displays the amount of time between the arm condition 
and the trigger. The time displayed will be from -0.04 microseconds to 41 .943 
milliseconds, less than -0.04 microseconds, or greater than 41.943 milliseconds. If 
the arm signal is ignored or the trigger is not in memory, a question mark (?) is 
displayed. 
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The "States" line shows the number of states that have been stored (out of the 
number that is possible to store) and the line numbers that the stored states occupy. 
(The trigger state is always stored on line 0.) 

The "Sequence term" line of the trace status display shows the number of the term 
the sequencer was in when the trace completed. Because a branch out of the last 
sequence term constitutes the trigger, the number displayed is what would be the 
next term (2 in the preceding example) even though that term is not defined. If the 
trace is halted, the sequence term number just before the halt is displayed; 
otherwise, the current sequence term number is displayed. If the current sequence 
term is changing too quickly to be read, a question mark (?) is displayed. 

The "Occurrence left" line of the trace status display shows the number of 
occurrences remaining before the primary branch can be taken out of the current 
sequence term. If the occurrence left is changing too quickly to be read, a question 
mark (?) is displayed. 
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To stop a trace measurement 

• Choose Trace— >Stop. 

• Using the command line, enter the stop_trace command. 

You can, and most likely will, specify traces whose trigger or storage states are 
never found. When this happens, the "Emulation trace complete" message is never 
shown, and the trace continues to run ("Emulation trace running"). When these 
situations occur, you can halt the trace measurement with the stop_trace command. 

The stop_trace command is also useful to deactivate signals which are driven 
when the trigger is found (refer to the "Making Coordinated Measurements" 
chapter). 



Examples To halt a trace measurement: 

stop_trace <RETURN> 

When the stop_trace command is entered, the message "Emulation trace halted" is 
displayed. 
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To display the trace 

• Choose Trace— ^Display or Display— >Trace. 

• Using the command line, enter the display trace command. 

You can display captured trace data with the display trace command. The 
available options to the display trace command are described in the "Modifying 
the Trace Display" section later in this chapter. 



Examples To display the trace: 

display trace <RETURN> 



[Trace List 


Depth=512 


Of f set =8 


More 


data off screen 1 


Label: 


Address 


Opcode 


or Status w/ Source Lines 


time count 


Base: 


symbols 




mnemnnin w/symbols 


relative 



8888888888update_sys.c -line 1 thru 47 S8ttSSSlttt8tttttttttt8flttttttS88tttttttttt 



Ittinclude <stdio.h> 



ijpdate_system( ) 

c 





| up. update_system 


LINK 86,800000 




240 


nS 


+001 


1 sysstack+003F90 


0000 sdata wr word 




240 


nS 


+oo; 


| sysstack+003F92 


2BE6 sdata wr word 




240 


nS 


+003 


update_sy+000002 


0000 sprog rd word 


ROM 


280 


nS 


+004 


update_sy+000004 


MOVEM.L D3-D4/R2-fl3,-(H7) 




240 


nS 


+ 005 


1 sysstack+003F8C 


0000 sdata wr word 




240 


nS 


+ 006 


| sysstack+003F8E 


CF94 sdata wr word 




240 


nS 


+007 


update_sy+00B006 


1830 sprog rd word 


ROM 


280 


nS 


+008 


update_sy+0BB088 


MOVER. L 8030007B32,fl2 




240 


nS 


+009 


|sysstack+003F8fl 


8464 sdata wr word 




240 


nS 



The first column in the trace list contains the line number. The trigger is always on 
lineO. 

The second column contains the address information associated with the trace 
states. Addresses in this column may be locations of instruction opcodes on fetch 
cycles, or they may be sources or destinations of operand cycles. 

The third column shows mnemonic information about the emulation bus cycle. 
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The next column shows the count information (time is counted by default). 
"Relative" indicates that each count is relative to the previous state. 

If your analyzer card contains external analysis (for example, HP 64703), the next 
column shows the data captured on the external trace signals. 

You can use the <NEXT> and <PREV> keys to scroll through the trace list a page 
at a time. The <Up arrow> and <Down arrow> keys will scroll through the trace 
list a line at a time. You can also display the trace list centered around a specific 
line number (for example, display trace 100 <RETURN>). Refer to the 
"Modifying the Trace Display" section for more information on the trace list 
display. 

Note that when a trigger condition is found but not enough states are captured to fill 
trace memory, the status line will show the trace is still running. You can display 
all but the last captured state in this situation; you must halt the trace to display the 
last captured state. 



To position the trace display on screen 

• Use the scroll bar or the <Up arrow>, <Down arrow>, <PREV>, <NEXT>, 
<CTRL>f, and <CTRL>g keys. 

The trace display command can display up to 1024 states, not all of which can 
appear on the screen at the same time. However, you can reposition the display on 
the screen with the keys described below. 

The <Up arrow> and <Down arrow> (or roll up and roll down) keys move the 
display up or down on the screen one line at a time. 

The <PREV> and <NEXT> (or page up and page down) keys allow you to move 
the display up or down a page at a time. 

The <CTRL>f and <CTRL>g keys allow you to move the display left or right, 
respectively. These keys are used when the width of the address or 
mnemonic/absolute columns is increased so that not all the trace display data can be 
displayed across the screen. 
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To change the trace depth 

• Using the command line, enter the display trace depth command. 

The display trace depth command allows you to specify the number of states that 
are displayed. By reducing the trace depth, you can shorten the time it takes for the 
Softkey Interface to upload the trace information. You can increase the trace depth 
to view more states of the current trace. 

If you wish to reduce the number of states that are displayed, the display trace 
depth command must be entered before the trace command. You cannot use this 
command to reduce the number of states displayed in the current trace. 



To modify the last trace command entered 

• Choose Trace— >Trace Spec and use the dialog box to select and edit a trace 
command. 

• Using the command line, enter the trace modify_command command. 

The Trace Specification Selection dialog box contains a list of trace specifications 
executed during the emulation session as well as any predefined trace specifications 
present at interface startup. 

You can predefine trace specifications and set the maximum number of entries for 
the dialog box by setting X resources (see the "Setting X Resources" chapter). 

The trace modify_command command recalls the last trace command. The 
advantage of this command over command recall is that you do not have to move 
forward and backward over other commands to find the last trace command; also, 
the last trace command is always available, no matter how many commands have 
since been entered. 
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Qualifying Trigger and Store Conditions 

This section describes tasks relating to the qualification of trigger and storage states. 

You can trigger on, or store, specific states or specific values on a set of trace 
signals (which are identified by trace labels). 

Also, you can prestore states. The prestore qualifier is a second storage qualifier 
used for storing states that occur before the normally stored states. Prestore is 
useful for capturing entry points to procedures or for identifying where global 
variables are accessed from. 

This section describes how to: 

• Qualify the trigger state and the trigger position in the trace. 

• Trigger on a number of occurrences of some state. 

• Qualify states stored in the trace. 

• Prestore states before qualified store states. 

• Change the count qualifier. 

• Trace until the analyzer is halted. 

• Cause the emulator to break into the monitor when the analyzer triggers. 
Expressions in Trace Commands 

When modifying the analysis specification, you can enter expressions which consist 
of values, symbols, and operators. 

Values Values are numbers in hexadecimal, decimal, octal, or binary. These 
number bases are specified by the following characters: 

B b Binary (example: 100101 10b). 

Q q O o Octal (example: 377o or 377q). 

D d (default) Decimal (example: 2048d or 2048). 
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H h Hexadecimal (example: 0a7fh). 

You must precede any hexadecimal number that begins 
with an A, B, C, D, E, or F with a zero. 

Don't care digits may be included in binary, octal, or hexadecimal numbers and 
they are represented by the letters X or x. A zero must precede any numerical value 
that begins with an "X". 

Symbols A symbol database is built when the absolute file is loaded into the 
emulator. Both global and local symbols can be used when entering expressions. 
Global symbols are entered as they appear in the global symbols display. When 
specifying a local symbol, you must include the name of the module ("anly.c") as 
shown below. 

anly . c : cmp_function 

Operators Analysis specification expressions may contain operators. All 
operations are carried out on 32-bit, two's complement integers. (Values which are 
not 32 bits will be sign extended when expression evaluation occurs.) 

The available operators are listed below in the order of evaluation precedence. 
Parentheses are also allowed in expressions to change the order of evaluation. 

-, ~ Unary two's complement, unary one's complement. The 

unary two's complement operator is not allowed on 
constants containing don't care bits. 

*, /, % Integer multiply, divide, and modulo. These operators are 

not allowed on constants containing don't care bits. 

+, - Addition, subtraction. These operators are not allowed on 

constants containing don't care bits. 

& Bitwise AND. 

I Bitwise inclusive OR. 

Values, symbols, and operators may be used together in analysis specification 
expressions. For example, if the local symbol exists, the following is a valid 
expression: 

module . c : symb+0b67dh&0f f f OOh 
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However, you cannot add two symbols unless one of them is an EQU type symbol. 
Emulation Analyzer Trace Signals 

When you qualify states, you specify values that should be found on the analyzer 
trace signals. The emulation analyzer trace signals are described in the table that 
follows. 



Emulation Analyzer Trace Signals 


Trace 


Signal 


Signal 




r> aiiie 


Tlac/irintinn 

l-ZcaCiip llUIl 




An aii 


Address Lines 0-23 


2A-5Y 




Status Lines 


24 


BYTE/WORD 


6800 (8-bit) Mode 


25 


READAYRITE 


Processor ReadAVrite 


26 


IN_CYC/EXT_CYC 


Processor IAC 


27 


FCO 


Function Code Bit 0 


28 


FC1 


Function Code Bit 1 


29 


FC2 


Function Code Bit 2 


30 


DMA 


Internal or External DMA (low) 


31 


BGD/FGD 


Background/Foreground Monitor 


32-47 


D0-D15 


Processor Data 0-15 


48 


EDMA 


External DMA 


49 


BCLR 


Bus Clear Signal 


50-53 


CS3-0 


Chip Select Signals 


54 


BERR 


Bus Error Signal 


55 


ROM 


ROM Memory Access Cycle 


56 


GRD 


Guarded Memory Access Cycle 


57-60 


PB11-8 


Port B pins 11-8 


61-63 


IPLO-2 


Interrupt Priority Level 
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State Qualifiers 

Whenever a state can be specified in the trace command (trigger state, storage state, 
prestore state, etc.), you will see the following softkeys that allow you to qualify the 
state: 

address The value following this softkey is searched for on the lines that 

monitor the emulation processor's address bus. 

data The value following this softkey is searched for on the lines that 

monitor the emulation processor's data bus. 

status The value following this softkey is searched for on the lines that 

monitor other emulation processor signals. Refer to the 
"Predefined Values for Status Qualifiers" description that 
follows. 

The following sofkeys are available if you have an emulation analyzer that has 64 
channels (for example, HP 64703 or HP 64704). 



cs The value following this softkey is searched for on the lines that 

monitor processor signals CSO through CS3. 

edma A value of 0 qualifies the state as an external DMA cycle. A 

value of 1 qualifies the state as an internal DMA cycle. 

grd A value of 0 qualifies the state as a guarded memory access. 

ipl The value following this softkey is searched for on the lines that 

monitor processor signals IPL2 through IPLO. 

pbclr A value of 0 qualifies the state as /BCLR active. 

pberr A value of 0 qualifies the state as /BERR active. 

pbio The value following this softkey is searched for on the lines that 

monitor processor signals PB1 1 through PB8. 

rom A value of 0 qualifies the state as a write to ROM. 
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extra Combines the edma, pbclr, cs, pberr, grd, rom, pbio, and ipl 

softkeys. Some values you can specify following the extra 
softkey are: 



Va lue 








Description 








n v v v v 

U 2\ 2\ 2\ 2\ 


xxxx 


xxxx 


vvfl vh 


BCLR active 








0 xxxx 


xxxx 


X XX 


xxxxb 


BERR active 








0 xxxx 


xxxx 


XX X 


xxxxb 


Chip select 


0 






0 xxxx 


xxxx 


XXX 


xxxxb 


Chip select 


1 






0 xxxx 


xxxx 


xxxx 


0 xxxb 


Chip select 


2 






0 xxxx 


xxxx 


xxxx 


x 0 xxb 


Chip select 


3 






n v v n v 
uxxux 


xxxx 


xxxx 


xxxxb 


Dedicated mode interrupt 1 




n v n v v 

U X U XX 






xxxxb 


Dedicated mode interrupt 6 




n n v v v 

u U XXX 


xxxx 


xxxx 


xxxxb 


Dedicated mode interrupt 7 




Oxxxx 


xxxx 


xxxx 


xxxOb 


External DMA 






Oxxxx 


xxxO 


xxxx 


xxxxb 


Guarded memory access 






Oxxxx 


xxxx 


xxxx 


xxxlb 


Internal DMA 






OllOx 


xxxx 


xxxx 


xxxxb 


Normal mode 


interrupt 


level 


1 


OlOlx 


xxxx 


xxxx 


xxxxb 


Normal mode 


interrupt 


level 


2 


OlOOx 


xxxx 


xxxx 


xxxxb 


Normal mode 


interrupt 


level 


3 


OOllx 


xxxx 


xxxx 


xxxxb 


Normal mode 


interrupt 


level 


4 


OOlOx 


xxxx 


xxxx 


xxxxb 


Normal mode 


interrupt 


level 


5 


OOOlx 


xxxx 


xxxx 


xxxxb 


Normal mode 


interrupt 


level 


6 


OOOOx 


xxxx 


xxxx 


xxxxb 


Normal mode 


interrupt 


level 


7 


00111 


xxxx 


xxxx 


xxxxb 










Oxxxx 


lxxx 


xxxx 


xxxxb 


PB10 high 








Oxxxx 


Oxxx 


xxxx 


xxxxb 


PB10 low 








Oxxxl 


xxxx 


xxxx 


xxxxb 


PB11 high 








OxxxO 


xxxx 


xxxx 


xxxxb 


PB11 low 








Oxxxx 


xxlx 


xxxx 


xxxxb 


PB8 high 








Oxxxx 


xxOx 


xxxx 


xxxxb 


PB8 low 








Oxxxx 


xlxx 


xxxx 


xxxxb 


PB9 high 








Oxxxx 


xOxx 


xxxx 


xxxxb 


PB9 low 








Oxxxx 


xxxx 


Oxxx 


xxxxb 


Write to ROM 







When a value is specified without one of these softkeys it is assumed to be an 
address value. 
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Predefined Values for Status Qualifiers When you specify status qualifiers 

for analyzer states (by pressing the status softkey), you will be given the following 
softkeys which are predefined values for the qualifiers. 



Softkev 


Value 




Description 


bgd 


OOxxx 


xxxxy 


Emulator in background 


byte 


Oxxxx 


xxxOy 


Byte cycle 


data 


OxxxO 


lxxxy 


Data cycle 


dm a 


Oxlxx 


xxxxy 


Bus released to DMA device 


ext eye 


Oxxxx 


xOxxy 


External processor cycle 


fgd 


Olxxx 


xxxxy 


Emulator in foreground 


int_cyc 


Oxxxx 


xlxxy 


Internal processor cycle 


intack 


Oxxll 


lxxxy 


Interrupt acknowledge cycle 


not_dma 


OxOxx 


xxxxy 


Bus not released to DMA device 


prog 


Oxxxl 


Oxxxy 


Program cycle 


react 


Oxxxx 


xxlxy 


Memory read 


sup 


Oxxlx 


xxxxy 


Supervisor data cycle 


supdata 


OxxlO 


lxxxy 


Supervisor cycle 


supprog 


Oxxll 


Oxxxy 


Supervisor program cycle 


user 


OxxOx 


xxxxy 


User cycle 


userdata 


OxxOO 


lxxxy 


User data cycle 


userprog 


OxxOl 


Oxxxy 


User program cycle 


word 


Oxxxx 


xxxly 


Word cycle 


write 


Oxxxx 


xxOxy 


Memory write 



These predefined values may be used as other values would be used. For example: 
trace after status write 



is the same as: 

trace after status OxxxxxxOxb 



To qualify the trigger state and position 

• Enter a trigger state specification in the entry buffer; then, choose Trace— >After (), 
Trace— >About (), or Trace— ^Before (). 

• When displaying memory in mnemonic format, position the mouse pointer over the 
source line where you want to set the trace trigger, press and hold the select mouse 
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button and choose Trace After, Trace Before, or Trace About from the popup 
menu. 

• Using the command line, enter the trace after, trace about, or trace before 

commands. 

Tracing after the trigger state says states that occur after the trigger state should be 
saved; in other words, the trigger is positioned at the top of the trace. 

Tracing before the trigger state says states that occur before the trigger state should 
be saved; in other words, the trigger is positioned at the bottom of the trace. 

Tracing about the trigger state says states that occur before and after the trigger 
state should be saved; in other words, the trigger is positioned at the center of the 
trace. 

When the analyzer counts time or states, the actual trigger position is within +/- 1 
state of the number specified. When counts are turned OFF, the actual trigger 
position is within +/- 3 states of the number specified. 

Usually, when you enter a trace about command, the trigger state (line 0) is 
labeled "about". However, if there are three or fewer states before the trigger, the 
trigger state is labeled "after". Likewise, if there are 3 or fewer states after the 
trigger, the trigger state is labeled "before". 

The state you define after trace after, trace about, or trace before is the state that 
will trigger the analyzer and cause states to be stored. 



257 



Chapter 7: Using the Emulation Analyzer 
Qualifying Trigger and Store Conditions 



Examples Suppose you want to look at the execution of the demo program after the call of the 

"update_system()" function (main.c: line 101) occurs. To trigger on this address, 
enter: 

trace after address main . "main . c" : line 101 <RETURN> 
set source on inverse_video on symbols on <RETURN> 
display trace <RETURN> 



Label: Address Opcode or Status w/ Source Lines time count 
Rasa: aijmhn 1 a mnpmnnir. m/sijmhn 1 s re 1 at i vb 



8888888888main. c - line 101 thru 102 888888888888888888888888888888888 





{ 


update_5L)st em( ) ; 












prog 


main+000012 JSR 


up. update_system 








+ 001 


prog 


main+000014 0000 


sprog rd word 


ROM 


240 


nS 


+002 


prog 


main+000016 31D4 


sprog rd word 


ROM 


280 


nS 



8888888888update_sys.c - line 1 thru 47 888888888888888888888888888 



ttinclude < stdio.h > 
vol d 

updat e_syst em ( ) 

{ 



+003 up. updat e_syst em LINK R6, 800000 

+004 I sysstack+003F90 0000 sdata wr word 

+005 | sysstack+003F92 2BE6 sdata wr word 

+006 update_sy+000002 0000 sprog rd word 



ROM 



240 nS 

240 nS 

240 nS 

280 nS 



In the preceding trace list, line 0 (labeled "after") shows the beginning of the 
program loop. 
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To trigger on a number of occurrences of some 
state 

• Use the occurs <#TIMES> after specifying the trigger state. 

When specifying a trigger state, you can include an occurrence count. The 
occurrence count specifies that the analyzer trigger on the Nth occurrence of some 
state. 

The default base for an occurrence count is decimal. You may specify occurrence 
counts from 1 to 65535. 



Examples To trigger on the 20th occurrence of the call of the "update_system()" function 

(main.c: line 101): 

trace after address main. "main.c" : line 101 occurs 20 

<RETURN> 
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To qualify states stored in the trace 

• Enter a storage state specification in the entry buffer; then, choose Trace— >Only (). 

• Using the command line, use the only option in the trace command. 

By default, all captured states are stored; however, you can qualify which states get 
stored with the trace command's only option. 



Examples When the emulator is running the demo program, to store only accesses of the 

"target_temp" variable: 

trace after main. "main.c" : line 101 
only target_temp <RETURN> 



race List Dept h-5 \2 Off set -3 More data off screen 



Label: Address Opcode or Status w/ Source Lines time count 

Easej symhnls mnemnm r m/sijmhn Is relati vr 

ttttttttttttttttttttmain.c - line 101 thru 102 8tttt»««ttttliatttt»»tttttt8«tttttttttttt»»8tttt»tt« 



{ 

update_si_)stem( ) ; 





prog main+888812 


JSR 


******** 






+001 


dat 


_target_temp 


885B 


sdata 


rd word 


1.62 


mS 


+082 


dat 


_target_t emp 


8858 


sdata 


wr word 


480 


nS 


+003 


dat 


_target_temp 


8858 


sdata 


rd word 


520 


nS 


+004 


dat 


_target_temp 


885R 


sdata 


rd word 


3.36 


mS 


+005 


dat 


_target_t emp 


eesR 


sdata 


rd word 


64. 1 


mS 


+006 


dat 


_target_t emp 


BBSfl 


sdata 


rd word 


2.24 


uS 


+007 


dat 


_target_t emp 


885H 


sdata 


rd word 


1. 12 


uS 


+008 


dat 


_target_temp 


885R 


sdata 


rd word 


1. 12 


uS 


+009 


dat 


_target_t emp 


eesR 


sdata 


rd word 


17.8 


mS 


+818 


dat 


_target_temp 


0059 


sdata 


wr word 


528 


nS 


+011 


dat 


_target_temp 


0059 


sdata 


rd word 


488 


nS 


+812 


dat 


_target_temp 


0059 


sdata 


rd word 


3.36 


mS 



Notice the trigger state (line 0, labeled "after") is included in the trace list; trigger 
states are always stored. 
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To prestore states before qualified store states 

• Enter a storage state specification in the entry buffer; then, choose Trace— >Only () 
Prestore. 

• Use the prestore option in the trace command. 

Prestore allows you to save up to two states which precede a normal store state. 
Prestore is turned off by default. However, you can use the trace command's 
prestore option to specify a prestore qualifier. 

Prestore is useful when you want to find the cause of a particular state. For 
example, if a variable is accessed from many different places in the program, you 
can qualify the trace so that only accesses of that variable are stored. Then, you can 
turn on prestore to find out where accesses of that variable originate from. 

States which satisfy the prestore qualifier and the storage qualifier at the same time 
are stored as normal states. 



Examples To storing only write accesses to the variable "target_temp" and prestore the two 

previous states: 

trace after main. "main.c" : line 101 
only target_temp status write 
prestore anything <RETURN> 
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Label: 




Address 


Of 


code or Status w/ Source Lines 


time count 


Base: 




sumbo Is 




mnemonic w/sumbols 


re 1 at i vr 


888tttttttttJtJt}mai n. c - 


1 i ne 


101 thru 


102 ttttttitttttttttttttttttttttttttt 


ttttttttttttttt«»tttttttttttttt 




{ 

updat e_sys 


t em ( ) ; 






1 


|after | 


proi 


;|main+000012 


JSR 








pstore 


dat 


_target_t emp 


0046 


sdata rd 


Luord 




pstore 
+003 


get. 
dat 


.targe+000050 
_target_temp 


ORI.W 
0045 


tt****, Dl 
sdata air 


ujord 


1.62 mS 


pstore 
pstore 
+006 


dat 
get_ 
dat 


_target_temp 
.targe+000050 
_target_t emp 


0045 
ORI.W 
0044 


sdata rd 
tt**#* ( Dl 
sdata wr 


ujord 
word 


83.3 mS 


pstore 


dat 


_target_t emp 


0044 


sdata rd 


word 




pstore 
+003 


get. 
dat 


.targe+000050 
_target_t emp 


ORI.W 
0043 


fl**** ( D 1 
sdata uur 


word 


55. 6 mS 


pstore 


dat 


_target_t emp 


0043 


sdata rd 


word 




p s X o r e 
+012 


get 
dat 


.targe+000050 
_target_temp 


ORI.W 

0042 


tt**** ( D 1 
sdata air 


Luord 


283. mS 



To change the count qualifier 

• Use the counting option in the trace command. 

After initializing the analyzer, the default count qualifier is "time", which means 
that the time between states is saved. When time is counted, up to 512 states can be 
stored in the trace. 

When you count states, the counter is incremented each time the state is captured 
(not necessarily stored) by the analyzer. When a state is counted, up to 512 states 
can be stored in the trace. 

When you turn OFF counting, up to 1024 states can be stored in the trace. 
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Examples Suppose you want to know how many loops of the program occur between calls of 

the "do_sort" function. To change the count qualifier to count a state that occurs 
once for each loop of the program, enter: 

trace only do_sort 

counting state main . "main . c" : line 101 <RETURN> 



set source off <RETURN> 



Label: 




Address 




Opcode or Status 


state count 


Base: 




sijmhnls 




mnemoni e w/sumbo Is 


relative 




set. 


.outpu+000032 


CMP.L 


D5,D4 




+001 


pro 


mai n. do_sort 


LINK 


R6, tt**** 


2 


+002 


pro 


mai n. do_sort 


LINK 


A6, tt**** 


4 


+003 


pro 


mai n. do_sort 


LINK 


A6, tt**** 


4 


+004 


pro 


mai n. do_sort 


LINK 


H6, It**** 


4 


+005 


pro 


mai n. do_sort 


LINK 


R6, tt**** 


4 


+006 


pro 


mai n. do_sort 


LINK 


fl6, tt**** 


4 


+ 007 


pro 


mai n. do_sort 


LINK 


R6,tt**** 


4 


+ 00i3 


pro 


mai n. do_sort 


LINK 


R6, tt**** 


4 


+009 


pro 


mai n. do_sort 


LINK 


R6 , tt**** 


4 


+ 010 


pro 


mai n. do_sort 


LINK 


flB, tt**** 


4 


+011 


pro 


mai n. do_sort 


LINK 


fl6, tt**** 


4 


+012 


pro 


mai n. do_sort 


LINK 


R6, tt**** 


4 


+013 


pro 


mai n. do_sort 


LINK 


R6, tt**** 


4 


+014 


pro 


mai n. do_sort 


LINK 


fl6, tt**** 


4 


+015 


pro 


mai n. do_sort 


LINK 


R6, tt**** 


4 



The trace listing above shows that the program loops 4 times for each call of the 
"do_sort" function. 
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To trace until the analyzer is halted 

• Choose Trace-^Until Stop. 

• Using the command line, enter the trace on_halt command. 

The trace on_halt command allows you to prevent triggering. In other words, the 
trace runs until you enter the stop_trace command. The trace on_halt command 
is the same as tracing before a state that never occurs. 

The trace on_halt command is useful, for example, when you wish to trace the 
states leading up to a break into the monitor. Suppose your program breaks on an 
access to guarded memory. To trace the states that lead up to the break, enter the 
trace on_halt command, and run the program. When the break occurs, the 
emulator is running in the background monitor, and the analyzer is no longer 
capturing states. To display the states leading up to the break, enter the stop_trace 
command (and the display trace command if traces are not currently being 
displayed). 

When the on_halt option is used in a trace command, the trigger condition (and 
position) options, as well as the repetitively and break_on_trigger options, cannot 
be included in the command. 

Also, note that this does not work the same when using a foreground monitor 
because the analyzer continues to capture states when the break to monitor occurs 
(unless the code that causes the break also causes processor to halt). In this case, 
you can use the command line to enter a trace command that stores only states 
outside the range of the foreground monitor program (for example, trace only not 
range <mon_start_addr> thru <mon_end_addr> on_halt). 
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To break emulator execution on the analyzer 
trigger 

• Enter a trigger state specification in the entry buffer; then, choose Trace— >Until (). 

• When displaying memory in mnemonic format, position the mouse pointer over the 
program line which you wish to trace before, press and hold the select mouse 
button and choose Trace Until from the popup menu. 

• Using the command line, use the break_on_trigger option to the trace command. 

The break_on_trigger option to the trace command allows you to cause the 
emulator to break when the analyzer finds the trigger state. 

Note that the actual break may be several cycles after the analyzer trigger. 



Examples To trace before source line 101 and cause the emulator to break into the monitor 

when the analyzer triggers: 

trace before address main. "main.c" : line 101 
break_on_tr±gger <RETURN> 
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Using the Sequencer 

When you use the analyzer's sequencer, you can specify traces that trigger on a 
series, or sequence, of states. You can specify a state which, when found, causes 
the analyzer to restart the search for the sequence of states. Also, the analyzer's 
sequencer allows you to trace "windows" of code execution. 

This section describes how to: 

• Trigger on a sequence of states. 

• Specify a global restart state. 

• Trace "windows" of program execution. 

The sequencing and windowing capabilities from within the Softkey Interface are 
not as powerful or flexible as they are from within the Terminal Interface. For 
example, in the Terminal Interface, you can specify different restart states for each 
sequence term and you can set up a windowing trace specification where the trigger 
does not have to be in the window. If you do not find the sequencing flexibility 
you need from within Softkey Interface, refer to the 68302 Emulator Terminal 
Interface User's Guide. 



To trigger after a sequence of states 

• Use the trace find_sequence command. 

The analyzer's sequencer has several levels (also called sequence terms). Each 
state in the series of states to be found before triggering, as well as the trigger state, 
is associated with a sequence term. 

The sequencer works like this: The analyzer searches for the state associated with 
the first sequence term. When that state is captured, the analyzer starts searching 
for the state associated with the second term, and so on. The last sequence term 
used is associated with the trigger state. When the trigger state is captured the 
analyzer is triggered. Up to seven sequence terms and an optional occurrence count 
for each term are available. 
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Examples In the demo program, suppose you wish to trigger on the following sequence of 

events: the "save_points" function, the "interrupt_sim" function, and finally the 
"do_sort" function. Also, suppose you wish to store only opcode fetches of the 
assembly language LINK A6,#0 instruction (data values that equal 4E56H) to show 
function entry addresses. 

To set up the sequencing trace specification, enter the following trace command. 

trace find_sequence save_points then interrupt_sim 
trigger about do_sort only data 4e5 6h <RETURN> 

set source off <RETURN> 



Label: 




Address 




Opcode or Status 


time count 


Ra^p : 




sumbo Is 




mnemonic w/symbo 1 s 


re lat i ve 


-011 


updat . wri te_hdwr 


4E56 


sprog rd word ROM 




sq adv 


upda. save_points 


4E56 


sprog rd word ROM 


4.32 mS 


sq adv 


ma. i nterrupt_sim 


4E56 


sprog rd word ROM 


3.23 mS 


-008 


pr. proc_speci f i c 


4E56 


sprog rd word ROM 


355. uS 


-007 


up. update_system 


LINK 


86, tt**** 


2.61 mS 


-006 


upda. get_targets 


LINK 


86, tt**** 


10.28 uS 


-005 


. read_conditions 


LINK 


86, tt**** 


1.62 mS 


-004 


upda. set_outputs 


LINK 


R6, tt**** 


35.4 mS 


-003 


updat . wri te_hdwr 


LINK 


86, tt**** 


32.0 mS 


-002 


upda. save_points 


LINK 


86, tt**** 


4.82 mS 


-001 


ma. i nterrupt_sim 


LINK 


86, tt**** 


3.22 mS 




pro 


mai n. do_sort 


LINK 


86, tt**** 


1.55 mS 


+001 


pro 


mai n. strcpy8 


LINK 


86,8**** 


4.51 mS 


+ 002 


pro 


main. strcpy8 


LINK 


86, tt**** 


130. uS 


+003 


pro 


main. strcpy8 


LINK 


86, tt**** 


130. uS 


+004 


pro 


mai n. strcpy8 


LINK 


86, tt**** 


190. uS 



Notice the states that contain "sq adv" in the first column (you may have to press 
<PREV> in order to see the states captured prior to the trigger). These are the 
states associated with (or captured for) each sequence term. Just as the trigger state 
is always stored in trace memory, the states captured in the sequence are always 
stored if the trace buffer is deep enough. 
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To specify a global restart state 

• Use the restart option to the trace command. 

When using the analyzer's sequencer, an additional sequence restart term is also 
allowed. This restart is a "global restart"; that is, it applies to all the sequence terms. 

The restart term is a state which, when captured before the analyzer has found the 
trigger state, causes the search for the sequence of states to start over. You can use 
the restart term to make certain some state does not occur in the sequence that 
triggers the analyzer. 



Examples In the demo program, suppose you wish to trigger on the following sequence of 

events: the "save_points" function, the "interrupt_sim" function, and the "do_sort" 
function. However, you only want to trigger when the "interrupt_sim" calls the 
"do_sort" function. In other words, if the "proc_specific" function is entered before 
the "do_sort" function is entered, you know "interrupt_sim" did not call "do_sort" 
this time, and the analyzer should start searching again from the beginning. 

Again, suppose you wish to store only opcode fetches of the assembly language 
LINK A6,#0 instruction (data values that equal 4E56H). 

To set up this sequencing trace specification, enter the following trace command. 

trace find_sequence save_points then interrupt_sim 
restart proc_specif ic trigger about do_sort only data 
4e56h <RETURN> 

set source off <RETURN> 
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race List 0epth=512 Of f set=B 



Label: 

Base: 




Address 
sumbo Is 




Opcode or Status 
mnemoni e m/symbo Is 


time count 
re lat i ve 


-007 


up. update_system 


LINK 


H6, 8**** 


2.61 


rn S 


-006 


upda. get_targets 


LINK 


R6, tt**** 


10.24 


uS 


-005 


. read_cond i t i ons 


LINK 


f)6, tt**** 


1.62 


mS 


-004 


upda. set_outputs 


LINK 


R6, tt**** 


6.58 


mS 


-003 


updat . wri te_hdwr 


LINK 


R6, tt**** 


32.0 


mS 


sq adv 


upda. save_poi nts 


LINK 


H6, tt**** 


4.82 


mS 


sq adv 


ma. i nterrupt_sim 


LINK 


R6, tt**** 


3.22 


rnS 




pro 


mai n. do_sort 


LINK 


RB , tt* * * * 


6. 17 


mS 


+001 


pro 


mai n. strcpy8 


LINK 


R6, tt**** 


4.51 


mS 


+002 


pro 


mai n. strcpy8 


LINK 


R6, tt**** 


130. 


uS 


+003 


pro 


mai n. strcpy8 


LINK 


R6, tt**** 


130. 


uS 


+004 


pro 


main. st rcpy8 


LINK 


R6, tt**** 


130. 


uS 


+005 


pro 


main. strcpy8 


LINK 


RB , tt* * * * 


130. 


uS 


+006 


pro 


main. st rcpy8 


LINK 


R6, tt**** 


130. 


uS 


+007 


pro 


mai n. strcpy8 


LINK 


R6, tt**** 


130. 


uS 


+008 


pro 


mai n. strcpyS 


LINK 


R6, tt**** 


130. 


uS 



Notice in the preceding trace (you may have to press <PREV> in order to see the 
states captured prior to the trigger) that, in addition to states captured in the 
sequence, "sq adv" is also shown next to states which cause a sequencer restart. 



To trace "windows" of program execution 

• Use the enable and disable options to the trace command. 

Windowing refers to the analyzer feature that allows you to turn on, or enable, the 
capturing of states after some state occurs then to turn off, or disable, the capturing 
of states when another state occurs. In effect, windowing allows you capture 
"windows" of code execution. 

Windowing is different than storing states in a range (the only range option in the 
trace command syntax) because it allows you to capture execution of all states in a 
window of code whereas storing states in a range won't capture the execution of 
subroutines that are called in that range or reads and writes to locations outside that 
range. 

When you use the windowing feature of the analyzer, the trigger state must be in 
the window or else the trigger will never be found. 
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If you wish to combine the windowing and sequencing functions of the analyzer, 
there are some restrictions: 

• Up to four sequence terms are available when windowing is in effect. 

• Global restart is not available when windowing is in effect. 

• Occurrence counts are not available. 



Examples In the demo program, suppose you are only interested in the execution that occurs 

within the switch statement of the "combsort" function. You could specify source 
line number 228 as the window enable state and the source line number of the next 
statement (line number 240) as the window disable state. Set up the windowing 
trace specification with the following command. 

trace enable main. "main.c" : line 228 disable 
main. "main. c" : line 240 <RETURN> 



set source on <RETURN> 















Label: 






Op 




time count 


Base: 




symbols 




mnemnnin in/sijmhnl* 


re lat i ve 






for (top= 


en-gap, i 


=0; i < top; i++) 


1 


sq adv 


| combsort+0000E2 


MOVER. L 


03. AO 


400 nS 




t888888888main.c - 


1 i ne 


227 thru 229 88888888888888888888 


1888888888888 






/* Force gap to cc 


nf orm to comb 1 1 */ 








swi t ch ( gap ) 






sq adv 




combsort+00009fl 


HOVE. L 


(fl3),D0 


1.30 mS 


+015 


da 1 mai n. swi tches 


0033 


sdata rd word 


240 n5 


+016 




switches+000002 


0000 


sdata rd word 


240 n5 


+017 


1 combsort+00009C 


CMPI.L 


tI00000000B,D0 


280 n5 


+018 




switches+000002 


0000 


sdata wr word 


240 nS 


+019 


da 1 mai n. swi tches 


0000 


sdata wr word 


240 nS 


+020 




data | mai n. gap 


0000 


sdata rd word 


240 n5 


+021 




main. gap+000002 


0031 


sdata rd word 


280 nS 


+022 




combsort+00009E 


0000 


sprog rd word ROM 


240 nS 


+023 




combsort+0000R0 


000B 


sprog rd word ROM 


240 nS 



Notice in the resulting trace (you have to press the <NEXT> key) that the enable 
and disable states have the "sq adv" string in the line number column. This is 
because the windowing feature uses the analyzer's sequencer. 
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Modifying the Trace Display 

This section describes the options available when displaying trace lists. 
This section describes how to: 

• Display the trace about a line number. 

• Display the trace, disassembling from a line number. 

• Display the trace in absolute format. 

• Display the trace in mnemonic format. 

• Display the trace with high-level source lines. 

• Display the trace with symbol information. 

• Change the column widths in the trace display. 

• Display time counts in absolute or relative format. 

• Display the trace with address information offset by a value. 

• Return to the default trace display. 

• Display the external analyzer information. 
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To display the trace about a line number 

• Use the <LINE #> option to the display trace command. 

The <LINE #> trace display option allows you to specify the line number to be 
centered in the display. 



Examples To display the trace about line number 72: 

set default <RETURN> 
display trace 7 2 < RE TURN > 





Label: 


Rddress 








Opcode 


or Status 


time count 


Ra^e : 


hex 








mnemoni c 


re lat 


i v e 


+865 


303172 


4 E B 9 


sprog 


rd 


word 


ROM 


240 


nS 


+066 


007B3R 


0000 


sdata 


rd 


word 




280 


nS 


+067 


007B3C 


0005 


sdata 


rd 


word 




240 


nS 


+ 068 


003174 


0000 


sprog 


rd 


word 


ROM 


240 


r,5 


+069 


007B3C 


0000 


sdata 


w r 


word 




240 


nS 


+070 


007B3R 


0000 


sdata 


Lur 


word 




280 


nS 


+071 


003176 


3190 


spr oq 


rd 


word 


ROM 


240 


nS 


+072 


003190 


4E56 


sprog 


rd 


word 


ROM 


240 


nS 


+073 


00CF88 


0000 


sdata 


wr 


word 




240 


nS 


+074 


00CF8R 


3178 


sdata 


wr 


word 




280 


nS 


+075 


003192 


0000 


sprog 


rd 


word 


ROM 


240 


nS 


+076 


003194 


207C 


sprog 


rd 


word 


ROM 


240 


nS 


+077 


00CF84 


0000 


sdata 


wr 


word 




240 


nS 


+078 


00CF86 


CF8C 


sdata 


w r 


word 




280 


nS 


+079 


003196 


0000 


sprog 


rd 


word 


ROM 


240 


nS 


+080 


003198 


759R 


sprog 


rd 


word 


ROM 


240 


nS 
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To display the trace, disassembling from a line 
number 

• Use the disassemble_from_line_number option to the display trace command. 

The "disassemble_from_line_number" trace display option causes the inverse 
assembler to attempt to begin disassembling the trace information from the 
specified line number. This option is required for inverse assemblers that cannot 
uniquely identify opcode fetch states on the processor bus. 

If the line number specified is not an opcode fetch state, the disassembled 
information will be incorrect. 



Examples To display the trace, disassembling from line number 72: 

display trace disassemble_from_line_number 7 2 <RETURN> 



|T r a c e L 


st De 


P th=512 


Of f set =3 




More data off s 


creen 1 


Label: 


Address 




Opcode or Status 


t ime 


count 


Base: 


hex 




mnerrion i c 




re 1 at i vr 


+07; 


003190 


LINK 


85. 800000 




243 


n5 


+673 


00CF88 


3300 


sdata wr word 




340 


nS 


+074 


00CF8B 


3178 


sdata ur word 




330 


nS 


+075 


003132 


3333 


sprog rd word 


ROM 


240 


nS 


+076 


003134 


MOVER. L 


8000007598,80 




240 


nS 


+077 


00CF84 


3333 


sdata wr word 




340 


nS 


+078 


00CF86 


CF8C 


sdata wr word 




300 


nS 


+ 079 


003136 


3330 


sprog rd word 


ROM 


240 


nS 


+080 


003193 


753fl 


sprog rd word 


ROM 


240 


nS 


+081 


003136 


MOVEQ.L 


8000000333, Dl 




240 


nS 


+082 


00313C 


NOP 






280 


nS 


+083 


003 13E 


MOVE.L 


D1.D0 




240 


nS 


+084 


003160 


HDD. L 


D0.D0 




240 


nS 


+085 


003182 


HDD. L 


D1,D0 




240 


nS 


+086 


003184 


LSL.L 


82, D0 




280 


nS 


+087 


003186 


MOVE.W 


800041, 333(80, D0.L) 




480 


nS 
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To display the trace in absolute format 

• Use the absolute option to the display trace command. 

The absolute trace display option allows you to display status information in 
absolute format (binary, hex, or mnemonic). The absolute status mnemonic 
display is the same as default mnemonic display, except that opcodes are not 
disassembled. 



Examples To display the trace in absolute format with the status information as binary values: 

display trace absolute status binary <RETURN> 



race List Depth-512 Offset-9 More data off screen 



Label: 


Address 


Data 




Absolute Status 


t ime 


count 


R*^p : 


hex 


he:-.. 




bi nary 


re lat i ve 


+ 072 


303130 


4E56 


101 1001 1 




240 


nS 


+073 


00CF88 


0000 


10101001 




240 


nS 


+074 


00CF8R 


3178 


10101001 




280 


nS 


+ 075 


003182 


0000 


10110011 




240 


n5 


+076 


003184 


207C 


10110011 




240 


nS 


+077 


00CF84 


0000 


10101001 




240 


nS 


+078 


00CF86 


CF8C 


10101001 




280 


nS 


+079 


003136 


0000 


10110011 




240 


nS 


+080 


003138 


759R 


10110011 




240 


nS 


+081 


003 18R 


7200 


101 1001 1 




240 


nS 


+082 


003 19C 


4E71 


10110011 




280 


nS 


+083 


003 19E 


2001 


10110011 




240 


nS 


+084 


003180 


D080 


10110011 




240 


nS 


+ 085 


0031R2 


D081 


10110011 




240 


nS 


+086 


0031R4 


E588 


10110011 




280 


nS 


+087 


003 1R6 


31BC 


10110011 




480 


nS 
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To display the trace in mnemonic format 

• Use the mnemonic option to the display trace command. 

The mnemonic trace display option allows you to display the trace information in 
mnemonic format (that is, opcodes and status). The default trace display is in 
mnemonic format. 



Examples To display the trace in mnemonic format: 

display trace mnemonic <RETURN> 



Label: 


Rddress 




Opcode or Status 


t ime 


count 


Ra^p : 


hex 




mnemoru c 




re lat i ve 


+ 072 


003130 


LINK 


R6, 800000 




240 


nS 


+073 


00CF88 


0000 


sdata wr word 




240 


nS 


+074 


00CF8R 


3178 


sdata wr word 




280 


nS 


+075 


003132 


0000 


sprog rd word 


ROM 


240 


nS 


+076 


003184 


MOVER. L 


800000759R,R0 




240 


nS 


+077 


00CF84 


0000 


sdata wr word 




240 


nS 


+078 


00CF86 


CF8C 


sdata wr word 




200 


nS 


+073 


003136 


0000 


sprog rd word 


ROM 


240 


nS 


+ 080 


003138 


759R 


sprog rd word 


ROM 


240 


nS 


+081 


003 13R 


MOVEQ. L 


8000000000,01 




240 


nS 


+082 


00313C 


NOP 






280 


nS 


+083 


00313E 


MOVE.L 


01, D0 




240 


nS 


+084 


0031R0 


RDD.L 


D0,D0 




240 


nS 


+085 


0031R2 


RDD.L 


D1.D0 




240 


nS 


+086 


003 1R4 


LSL. L 


82, D0 




280 


nS 


+087 


003 1R6 


MOVE.H 


800041, 000(R0,D0.L) 




480 


nS 
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To display the trace with high-level source lines 

• Use the set source command. 

To include high-level source lines in the trace display, you must use the set 
command. The set command allows you to include symbolic information in trace, 
memory, register, and software breakpoint displays. The set command affects all 
displays for the current window. 

The set source on/off/only command allows you to include source file information 
in the trace list or memory mnemonic display. The source only option specifies 
that only the source file information will be displayed. 

When source lines are included, comments that contain file and line information 
appear before the source lines. 

Also, when source lines are turned on, three additional options are available in the 
set command: inverse video, tabs are, and number of source lines. 

The inverse_video option allows you to display source lines in inverse video. 

The tabs_are option allows you to specify the number of spaces between tab stops 
so that the appropriate number of spaces can be inserted for source lines. The 
default value is eight. Values from two to 15 can be entered. 

Typically, there are lines in the source file that are not associated with actual 
instructions (declarations, comments, etc.). The number_of_source_lines option 
allows you to specify the number of these source lines to be displayed for every 
source line that is associated with an actual instruction. Only source lines up to the 
the previous source line that corresponds to actual code will be displayed. The 
default value is five. Values from one to 50 can be entered. 



Examples To display the trace with high-level source lines: 

set source on <RETURN> 
display trace <RETURN> 
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Label: 
Rase: 



Address 
hex 



Opcode or Status w/ Source Lines 



mnfimnni r. 



time count 
re 1 at i vr 



80 tJ8888«fl«SStttttttt»»»88«8ttatttttt 



8888888888i ni t_system. c - line 66 thru 
» Returns: Nothing. 

************************************************************************* 
voi d 

init_val_arr( ) 
( 



+072 


003190 


LINK 


R6, 800000 




240 


nS 


+B73 


00CF88 


0000 


sdata wr word 




240 


nS 


+074 


00CF8R 


3178 


sdata ur word 




880 


nS 


+075 


003192 


0000 


sprog rd word 


ROM 


240 


nS 


+076 


003194 


MOVER. L 


800000759R,R0 




240 


nS 


+077 


QQCFB4 


0000 


sdata wr word 




240 


nS 


+ 078 


00CF86 


CF8L 


sdata wr word 




880 


nS 


+079 


003196 


0000 


sprog rd word 


ROM 


240 


nS 


+080 


003198 


759R 


sprog rd word 


ROM 


240 


nS 



8888888888ini t_system. c - line 81 thru 



82 88888888888888888888888888 



To set the number of source lines to be displayed at 12: 

set source on number_of_source_lines 12 <RETURN> 
display trace <RETURN> 



Label: Address Opcode or Status w/ Source Lines time count 

Eaae.; heji mnemoni c re lat i ve 

8888888888init_system.c - line 66 thru 80 88888888888888888888888888 
* 

* Description: This code initializes the val_arr data structure. 
* 

* Parameters: none 

* 

* References: None. 
* 

» Returns: Nothing. 

******************************************************************* ****** 
voi d 

init_val_arr( ) 
{ 

+072 003190 LINK R6, 800000 240 nS 

+073 00CF88 0000 sdata wr word 240 nS 

+074 00CF8R 3178 sdata wr word 280 nS 
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To display the trace with symbol information 

The set symbols on/off command allows you to specify that address information be 
displayed in terms of program symbols. 



Examples To display the trace with symbol information: 

set source off symbols on <RETURN> 
display trace <RETURN> 



Label: 


Address 




Opcode or Status 




time count 


Base: 


sumbo Is 




mnemonic w/sumbols 


relat 


i VR 


+072 i ni . i ni t_va l_arr 


LINK 


R6, 800000 




240 


nS 


+073 


sysstack+003F88 


0000 


sdata wr uuord 




240 


nS 


+074 


sysstack+003F8fl 


3178 


sdata wr word 




280 


nS 


+075 init_val_+000002 


0000 


sprog rd word 


ROM 


240 


nS 


+076 init_val_+000004 


MOVER. L 


800000753R.R0 




240 


nS 


+077 


sysstack+003F84 


0000 


sdata uir word 




240 


nS 


+078 


sysstack+003F86 


lfbi: 


sdata wr word 




280 


r,5 


+079 init_val_+000006 


0000 


sprog rd word 


ROM 


240 


nS 


+080 init_val_+000008 


753R 


sprog rd word 


ROM 


240 


nS 


+081 init_val_+00000fl 


MOVEQ.L 


8000000000,01 




240 


nS 


+082 init_val_+00000C 


NOP 






280 


n j 


+083 init_val_+00000E 


MOVE.L 


D1.D0 




240 


nS 


+084 init_val_+000010 


RDD.L 


D0, D0 




240 


nS 


+085 init_val_+000012 


RDD.L 


01, D8 




240 


nS 


+086 init_val_+000014 


LSL.L 


82, D0 




280 


nS 


+087 init_val_+000016 


MOVE.W 


800041, 000(R0,D0.L) 




480 


nS 
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To change column widths in the trace display 



• Use the set width command. 

The set width command allows you to change the width of the address and 
mnemonic (or absolute) columns in the trace list. Values from one to 80 can be 
entered. 

When address information is being displayed in terms of symbols (in other words, 
symbols on), you may wish to increase the width of the address column to display 
more of the symbol information. 

When trace information is displayed in mnemonic format, you can additionally 
specify the width of symbols in the "Opcode or Status" column. 



Examples 



To display the trace with the address column width set to 30 characters: 



set width label 30 <RETURN> 
display trace <RETURN> 



Label: 
Rase: 



Address 

symbols 

prog | init_system. init_val_arr 



Opcode or Status 

mnemonic m/symbols 

H6, ttBBBBB 



+072 
+073 
+074 
+075 
+076 
+077 
+078 
+079 
+ 080 
+081 
+082 
+083 
+084 
+085 
+086 
+087 



stack | sysstack+003F8R 
prog I init_val_arr+000002 
prog | init_val_arr+000004 



stack | sysstack+803F86 
prog i ni t_va l_arr+800006 
prog init_val_arr+080008 
prog init_val_arr+00000fl 
prog init_val_arr+000O0C 
prog init_val_arr+00O00E 
prog init_val_arr+000010 
prog init_val_arr+000012 
prog init_val_arr+000014 
prog init_val_arr+000016 



stack I sysstack+003F88 



stack I sysstack+003F84 



MOVEQ.L 
NOP 

MOVE.L 

RDD.L 

RDD.L 

LSL.L 

MOVE.W 



MOVER. L 



LINK 



0000 
3178 
0000 



0000 
CF8C 
0000 
759R 



800041, 000(R0,D0.L) 




D1.D0 
D0,D0 
D1,D0 
S2,D0 



ROM 
ROM 



ROM 
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To display time counts in absolute or relative 
format 

• Use the count option to the display trace command. 

Count information may be displayed two ways: relative (which is the default), or 
absolute. When relative is selected, count information is displayed relative to the 
previous state. When absolute is selected, count information is displayed relative to 
the trigger condition. 

The count absolute/relative trace display option is not available when counting is 
turned off in the trace command. 



Examples To display the trace with absolute time counts: 

set default <RETURN> 

display trace count absolute <RETURN> 



Label: 
Rase : 


Address 
hex 




Opcode or Status 
mnemoni c 


time count 
abso lute 


+ 072 


003190 


LINK 


fib, 800000 




+ 


18.00 


uS 


+073 


00CF88 


0000 


sdata wr word 




+ 


18.24 


uS 


+074 


00CF8R 


3178 


sdata wr word 




+ 


18.52 


uS 


+075 


003132 


0000 


sprog rd word 


ROM 


+ 


18.76 


uS 


+076 


003134 


MOVER. L 


800000753R,R0 




+ 


13.00 


uS 


+077 


00CF84 


0000 


sdata wr word 




+ 


19.24 


uS 


+078 


00CF36 


CF8C 


sdata wr word 




+ 


19.52 


uS 


+079 


003196 


0000 


sprog rd word 


ROM 


+ 


19.76 


uS 


+080 


003198 


759R 


sprog rd word 


ROM 


+ 


20.00 


uS 


+081 


003 13fi 


MOVEQ.L 


8000000000, Dl 




+ 


20.24 


uS 


+082 


003 13C 


NOP 






+ 


20.52 


uS 


+083 


00313E 


MOVE.L 


D1.D0 




+ 


20. 76 


uS 


+084 


0031R0 


RDD.L 


00,00 




+ 


21. 00 


ub 


+ 0135 


0031R2 


RDD.L 


D1,D0 




+ 


21. 24 


uS 


+086 


003 1R4 


LSL.L 


82, D0 




+ 


21.52 


uS 


+087 


003 1R6 


MOVE.H 


80004 1,000(R0,D0.L) 




+ 


22.00 


uS 
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To display the trace with addresses offset 

• Use the offsetjby option to the display trace command. 

The offsetjby trace display option allows you to cause the address information in 
the trace display to be offset by the amount specified. The offset value is subtracted 
from the instruction's physical address to yield the address that is displayed. 

If code gets relocated and therefore makes symbolic information obsolete, you can 
use the offsetjby option to change the address information so that it again agrees 
with the symbolic information. 

You can also specify an offset to cause the listed addresses to match the addresses 
in compiler or assembler listings. 



Examples To display the trace with addresses offset by 3 190H: 

display trace offset_by 3190h <RETURN> 



Label: 


Address 




Opcode or Status 


t ime 


count 


R ^ :-. f- : 


he:-. 




mnemonic 






+072 


000000 


LINK 


R6,B00000 




240 


nS 


+073 


009DF8 


0000 


sdata wr word 




240 


nS 


+074 


009OFR 


3178 


sdata wr word 




280 


nS 


+075 


000002 


0300 


sprog rd word 


ROM 


248 


nS 


+076 


888884 


MOVER. L 


S00000759R.R0 




040 


nS 


+077 


003DF4 


0000 


sdata wr word 




240 


nS 


+078 


009DF6 


CF8C 


sdata wr word 




280 


nS 


+079 


000006 


0000 


sprog rd word 


ROM 


240 


nS 


+ 088 


000008 


7538 


sprog rd word 


ROM 


240 


nS 


+081 


088888 


MOVEO.L 


8088888880.01 




040 


nS 


+082 


00000C 


NOP 






280 


nS 


+083 


00000E 


MOVE.L 


□ 1,00 




240 


nS 


+084 


000010 


F1DD.L 


00, D0 




240 


nS 


+085 


000012 


flDO.L 


D1.D0 




240 


nS 


+886 


008814 


LSL.L 


B2.D0 




280 


nS 


+087 


000016 


MOVE.N 


800041, 000(R0,D0.L) 




480 


nS 
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To return to the default trace display 

• Use the set default command. 

The set default command allows you to return to the default display. 



Examples To return to the default trace display: 

set default <RETURN> 



[Trace L 


st De 


pth=512 


Of f set=0 


H 


ore data off s 




Label: 


Address 




Opcode or Status 


1 1 me 


count 


Rase : 


hex 




mnemonic 








+872 


003130 


LINK 


R6, 800000 




240 


nS 


+073 


00CF88 


0300 


sdata air word 




240 


nS 


+074 


00CF8R 


3178 


sdata wr word 




280 


nS 


+075 


003132 


0000 


sprog rd word 


ROM 


240 


nS 


+076 


003134 


MOVER. L 


8000007S3R.R0 




240 


nS 


+077 


00CF84 


0000 


sdata wr word 




240 


nS 


+078 


00CF86 


CF8C 


sdata wr word 




280 


nS 


+079 


003136 


0000 


sprog rd word 


ROM 


240 


nS 


+080 


003138 


759R 


sprog rd word 


ROM 


240 


nS 


+081 


00313R 


MOVEQ.L 


8000000000, Dl 




240 


nS 


+082 


003 13C 


NOP 






280 


nS 


+083 


00313E 


MOVE.L 


D1.D0 




240 


nS 


+084 


003180 


HDD. L 


D0.D0 




240 


nS 


+085 


0031R2 


HDD. L 


D1.D0 




240 


nS 


+086 


0031R4 


LSL. L 


82, D0 




280 


nS 


+087 


003 1R6 


MOVE.H 


800041, 000(R0,D0.L) 




480 


nS 
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To display external analyzer information 

• Use the external option to the display trace command. 

The external trace display option allows you to include data from the external 
analyzer in the trace list. External bits are displayed by default. If you do not wish 
to have the external bits information in the display, you can turn them off. 

The bits associated with the external analyzer labels may be displayed in binary or 
hexadecimal format. Labels must be defined in the external analyzer configuration 
(and prior to trace command entry) before they appear as softkey selections when 
displaying the trace. Refer to the "To define labels for the external analyzer 
signals" description in the "Using the External State Analyzer" chapter. 



Examples To display the "xbits" column in binary format: 

display trace external xbits binary <RETURN> 



[Trace 


List Off set =0 




More 


data off screen 1 


Label 


Opcode or Status 


t ime 


count 


xbi ts 


Base: 


mnemoni c 


re lat i ve 


hi nary 


+072 


fl6, 900000 


400 


nS 


0000000000000000 


+073 


supr data wr word 


400 


nS 


0000000000000000 


+074 


supr data wr word 


400 


nS 


0000000000000000 


+075 


supr prog 


400 


nS 


0000000000000000 


+076 


L »000007158,fl0 


400 


nS 


0000000000000000 


+077 


supr data wr word 


400 


nS 


0000000000000000 


+078 


supr data wr word 


400 


nS 


0000000000000000 


+079 


supr prog 


400 


nS 


0000000000000000 


+080 


supr prog 


400 


nS 


0000000000000000 


+081 


L S000000000.D1 


400 


nS 


0000000000000000 


+082 




400 


nS 


0000000000000000 


+083 


D1.D0 


400 


nS 


0000000000000000 


+084 


D0,D0 


400 


nS 


0000000000000000 


+085 


01, Q0 


400 


nS 


0000000000000000 


+ 086 


«2.DQ 


400 


nS 


0000000000000000 


+087 


800041, 000(fl0, 08. L) 


800 


nS 


0000000000000000 
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Saving and Restoring Traces 

The emulator/analyzer interface allow you to save trace commands and trace lists. 
You can restore trace commands in order to set up the same trace specification. 
You can restore traces in order to view trace data captured in the stored trace. 

This section describes how to: 

• Save trace commands. 

• Restore trace commands. 

• Save traces. 

• Restore traces. 



To save trace commands 

• Choose File->Store->Trace Spec. 

• Using the command line, enter the store trace_spec command. 

You can save a trace command to a "trace specification" file and reload it at a later 
time. 

The trace command is saved in a file named "tspecfile.TS" in the current directory. 
The extension ".TS" is appended to trace specification files if no extension is 
specified in the store trace_spec command. 



Examples To store the current trace command: 

store trace_spec tspecfile <RETURN> 
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To restore trace commands 

• Choose File— >Load— >Trace Spec. 

• Using the command line, enter the load trace_spec command. 

Trace commands that are restored will always work, even if symbols have been 
changed; however, once you modify the trace command, it may no longer work. 

Loading a trace specification does not start the trace; to do this, you must enter the 
trace command either by selecting it from the Trace Specification Selection dialog 
box or by using the Trace— >Again pulldown menu item. 



Examples To bring back the trace command saved in "tspecfile.TS" and perform a trace 

measurement using it: 

load trace_spec tspecfile <RETURN> 
trace again <RETURN> 
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To save traces 

• Choose File->Store->Trace Data. 

• Using the command line, enter the store trace command. 

You can save a trace to a trace file and reload it at a later time. 

The trace is saved in a file named "trcfile.TR" in the current directory. The 
extension ".TR" is appended to trace files if it is not specified in the store trace 
command. 

Examples To store the current trace: 

store trace trcfile <RETURN> 



286 



Chapter 7: Using the Emulation Analyzer 
Saving and Restoring Traces 



To restore traces 

• Choose File->Load->Trace Data. 

• Using the command line, enter the load trace command. 

The restored trace depth is the depth specified when the trace was stored and cannot 
be increased. You may want to increase the trace depth before storing traces. 

When a trace is loaded, the trace command is not restored. A trace again or trace 
modify command will use the last trace command entered, not the command which 
resulted in the loaded trace. Also, the trace status shown by the display status 
command does not reflect the loaded trace. 



Examples To restore the "trcfile.TR" trace file: 

load trace trcfile <RETURN> 

The trace information stored in "trcfile.TR" is restored. You can view the trace as 
you would any other trace. 
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Making Software Performance 
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The Software Performance Measurement Tool (SPMT) is a feature of the Softkey 
Interface that allows you to make software performance measurements on your 
programs. 

The SPMT allows you to make some of the measurements that are possible with the 
HP 64708 Software Performance Analyzer and its Graphical User Interface 
(HP B 1487). 

The SPMT post-processes information from the analyzer trace list. When you end 
a performance measurement, the SPMT dumps the post-processed information to a 
binary file, which is then read using the perf32 report generator utility. 

Two types of software performance measurements can be made with the SPMT: 
activity measurements, and duration measurements. 

This chapter describes tasks you perform while using the Software Performance 
Measurement Tool (SPMT). These tasks are grouped into the following sections: 

• Activity performance measurements. 

• Duration performance measurements. 

• Running performance measurements and creating reports. 
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Activity Performance Measurements 

Activity measurements are measurements of the number of accesses (reads or 
writes) within an address range. The SPMT shows you the percentage of analyzer 
trace states that are in the specified address range, as well as the percentage of time 
taken by those states. Two types of activity are measured: memory activity, and 
program activity. 

Memory activity is all activity that occurs within the address range. 

Program activity is the activity caused by instruction execution in the address 
range. Program activity includes opcode fetches and the cycles that result from the 
execution of those instructions (reads and writes to memory, stack pushes, etc.). 

For example, suppose an address range being measured for activity contains an 
opcode that causes a stack push, which results in multiple write operations to the 
stack area (outside the range). The memory activity measurement will count only 
the stack push opcode cycle. However, the program activity measurement will 
count the stack push opcode cycle and the write operations to the stack. 

By comparing the program activity and the memory activity in an address range, 
you can get an idea of how much activity in other areas is caused by the code being 
measured. An activity measurement report of the code (prog), data, and stack 
sections of a program is shown below. 

Label 
prog 

Address Range ADEH thru 1261H 



Memory Activity 



State 


Percent 


Rel = 


57 . 


. 77 


Abs = 


57 . 


, 77 






Mean = 


295. 


.80 


Sdv = 


26. 


, 77 


Time 


Percent 


Rel = 


60. 


. 97 


Abs = 


60. 


, 97 



Program Activity 



State 


Percent 


Rel = 


99. 


. 82 


Abs = 


99. 


82 






Mean = 


511 . 


. 10 


Sdv = 


0 . 


88 


Time 


Percent 


Rel = 


99. 


.84 


Abs = 


99. 


84 



data 

Address Range 6007AH thru 603A5H 



Memory Activity 

State Percent Rel = 30.51 Abs = 30.51 

Mean = 156.20 Sdv = 31.87 

Time Percent Rel = 28.09 Abs = 28.09 
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Program Activity 

State Percent Rel = 0.18 Abs = 0.18 
Mean = 0.90 Sclv = 0.88 
Time Percent Rel = 0.16 Abs = 0.16 

stack 

Address Range 40000H thru 43FFFH 



Memory Activity 



State Percent 


Rel = 


11 . 


. 72 


Abs = 


11 


. 72 




Mean = 


60. 


.00 


Sdv = 


29. 


,24 


Time Percent 


Rel = 


10. 


. 94 


Abs = 


10. 


, 94 


:am Activity 














State Percent 


Rel = 


0 . 


. 00 


Abs = 


0 . 


, 00 




Mean = 


0. 


. 00 


Sdv = 


0. 


.00 


Time Percent 


Rel = 


0. 


.00 


Abs = 


0. 


.00 



prog 
data 
stack 



Graph of Memory Activity relative state percents >= 1 



57 . 77% 
30 .51% 
11 . 72% 



t********************** 



prog 
data 
stack 



Graph of Memory Activity relative time percents >= 1 
60 97% ******************************* 
28 09% ************** 
10 . 94% 



****** 



Graph of Program Activity relative state percents >= 1 
prog 99 82% ************************************************** 



Graph of Program Activity relative time percents >= 1 
prog 99 g4% ************************************************** 

Summary Information for 10 traces 



Memory Activity 
State count 

Relative count 5120 

Mean sample 170.67 

Mean Standard Dv 29.30 

95% Confidence 12.28% Error tolerance 
Time count 

Relative Time - Us 2221.20 



Program Activity 
State count 

Relative count 5120 

Mean sample 170.67 

Mean Standard Dv 0.58 

95% Confidence 0.24% Error tolerance 
Time count 

Relative Time - Us 2221.20 
Absolute Totals 
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Absolute count - state 5120 
Absolute count - time - Us 2221.20 

This section describes how to: 

• Set up the trace command for activity measurements. 

• Initialize activity performance measurements. 

• Interpret activity measurement reports. 



To set up the trace command for activity 
measurements 

1 Specify a trace display depth of 5 12. 

2 Trace after any state, store all states, and count time. 

Before you initialize and run performance measurements, the current trace 
command (in other words, the last trace command entered) must be properly set up. 

In general, you want to give the SPMT as many trace states as possible to 
post-process, so you should increase the trace depth to the maximum number, as 
shown in the following command. 

If you wish to measure activity as a percentage of all activity, the current trace 
command should be the default (in other words, trace <RETURN>). The default 
trace command triggers on any state, and all captured states are stored. It is 
important that time be counted by the analyzer; otherwise, the SPMT measurements 
will not be correct. Also, since states are stored "after" the trigger state, the 
maximum number of captured states appears in each trace list. 

You can qualify trace commands any way you like to obtain specific information. 
However, when you qualify the states that get stored in the trace memory, your 
SPMT results will be biased by your qualifications; the percentages shown will be 
of only those states stored in the trace list. 
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Examples To specify a trace depth of 5 1 2: 

display trace depth 512 <RETURN> 

To trace after any state, store all states, and count time: 
trace counting time <RETURN> 



To initialize activity performance measurements 

• Use the performance_measurement_initialize command. 

After you set up the trace command, you must tell the SPMT the address ranges on 
which you wish to make activity measurements. This is done by initializing the 
performance measurement. You can initialize the performance measurement in the 
following ways: 

• Default initialization (using global symbols if the symbols database is loaded). 

• Initialize with user-defined files. 

• Initialize with global symbols. 

• Initialize with local symbols. 

• Restore a previous performance measurement (if the emulation system has 
been exited and reentered). 

Default Initialization 

Entering the performance_measurement_initialize command with no options 
specifies an activity measurement. If a valid symbolic database has been loaded, 
the addresses of all global procedures and static symbols will be used; otherwise, a 
default set of ranges that cover the entire processor address range will be used. 
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Initialization with User Defined Ranges 

You can specifically give the SPMT address ranges to use by placing the 
information in a file and entering the file name in the 
per formance_measur ement_initialize command . 

Address range files may contain program symbols (procedure name or static), user 
defined address ranges, and comments. An example address range file is shown 
below. 

# Any line which starts with a # is a comment. 

# All user's labels must be preceded by a "I". 

|users_label 10H 1000H 
program_symbol 

# A program symbol can be a procedure name or a static. In the case of a pro- 

# cedure name the range of that procedure will be used. 

I users_label2 program_symbol 1 -> program_symbol2 

# "->" means thru. The above will define a range which starts with symboll 

# and goes thru symbol2 . If both symbols are procedures then the range will 

# be defined as the start of symboll thru the end of symbol2. 

dirl/dir2/source_f ile . s : local_symbol 

# The above defines a range based on the address of local_symbol . 

Initialization with Global Symbols 

When the performance_measurement_initialize command is entered with no 
options or with the global_symbols option, the global symbols in the symbols 
database become the address ranges for which activity is measured. If the symbols 
database is not loaded, a default set of ranges that cover the entire processor address 
range will be used. 

The global symbols database contains procedure symbols, which are associated 
with the address range from the beginning of the procedure to the end, and static 
symbols, which are associated with the address of the static variable. 

Initialization with Local Symbols 

When the performance_measurement_initialize command is entered with the 
local_symbols_in option and a source file name, the symbols associated with that 
source file become the address ranges for which activity is measured. If the 
symbols database is not loaded, an error message will occur telling you that the 
source filename symbol was not found. 
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You can also use the local_symbols_in option with procedure symbols; this allows 
you to measure activity related to the symbols defined in a single function or 
procedure. 

Restoring the Current Measurement 

The performance_measurement_initialize restore command allows you to 
restore old performance measurement data from the perf.out file in the current 
directory. 

If you have not exited and reentered emulation, you can add traces to a performance 
measurement simply by entering another performance_measurement_run 
command. However, if you exit and reenter the emulation system, you must enter 
the performance_measurement initialize restore command before you can add 
traces to a performance measurement. When you restore a performance 
measurement, make sure your current trace command is identical to the command 
used with the restored measurement. 

The restore option checks the emulator software version and will only work if the 
perf.out files you are restoring were made with the same software version as is 
presently running in the emulator. If you ran tests using a former software version 
and saved perf.out files, then updated your software to a new version number, you 
will not be able to restore old perf.out measurement files. 
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Examples Suppose the "addr_ranges" file contains the names of all the functions in the "ecs" 

demo program loop: 

combsort 
do_sort 

gen_ascii_data 

get_targets 

graph_data 

inter rupt_sim 

proc_specif ic 

read_conditions 

save_points 

set_outputs 

strcpy8 

update_system 

write_hdwr 

Since these labels are program symbols, you do not have to specify the address 
range associated with each label; the SPMT will search the symbol database for the 
addresses of each label. 

An easy way to create the "addr_ranges" file is to use the copy global_symbols 
command to copy the global symbols to a file named "addr_ranges"; then, fork a 
shell to UNIX (by entering "! <RETURN>" on the Softkey Interface command 
line) and edit the file so that it contains the procedure names shown above. Enter a 
<CTRL>d at the UNIX prompt to return to the Softkey Interface. 

To initialize the activity measurement with a user-defined address range file: 

p&rformancs_m&asurement_initializ& addr_ranges <RETURN> 
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To interpret activity measurement reports 

View the performance measurement report. 

Activity measurements are measurements of the number of accesses (reads or 
writes) within an address range. The reports generated for activity measurements 
show you the percentage of analyzer trace states that are in the specified address 
range, as well as the percentage of time taken by those states. The performance 
measurement must include four traces before statistics (mean and standard 
deviation) appear in the activity report. The information you will see in activity 
measurement reports is described below. 

Memory Activity All activity found within the address range. 

Program Activity All activity caused by instruction execution in the address 
range. Program activity includes opcode fetches and the cycles that result from the 
execution of those instructions (reads and writes to memory, stack pushes, etc.). 

Relative With respect to activity in all ranges defined in the performance 
measurement. 

Absolute With respect to all activity, not just activity in those ranges defined in 
the performance measurement. 

Mean Average number of states in the range per trace. The following equation is 
used to calculate the mean: 



mean = states , in ran Z e 
total states 
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Standard Deviation Deviation from the mean of state count. The following 
equation is used to calculate standard deviation: 



std dev = a / ^ _ ^ x ^ Ssumq - N (mean f 



Where: 

N Number of traces in the measurement. 

mean Average number of states in the range per trace. 

Ssumq Sum of squares of states in the range per trace. 

Symbols Within Range Names of other symbols that identify addresses or 
ranges of addresses within the range of this symbol. 

Additional Symbols for Address Names of other symbols that also identify 
this address. 

Note that some compilers emit more than one symbol for certain addresses. For 
example, a compiler may emit "interrupt_sim" and "_interrupt_sim" for the first 
address in a routine named interrupt_sim. The analyzer will show the first symbol 
it finds to represent a range of addresses, or a single address point, and it will show 
the other symbols under either "Symbols within range" or "Additional symbols for 
address", as applicable. In the "interrupt_sim" example, it may show either 
"interrupt_sim" or "_interrupt_sim" to represent the range, depending on which 
symbol it finds first. The other symbol will be shown below "Symbols within 
range" in the report. These conditions appear particularly in default measurements 
that include all global and local symbols. 

Relative and Absolute Counts Relative count is the total number of states 
associated with the address ranges in the performance measurement. Relative time 
is the total amount of time associated with the address ranges in the performance 
measurement. The absolute counts are the number of states or amount of time 
associated with all the states in all the traces. 
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Error Tolerance and Confidence Level An approximate error may exist in 
displayed information. Error tolerance for a level of confidence is calculated using 
the mean of the standard deviations and the mean of the means. Error tolerance 
gives an indication of the stability of the information. For example, if the error is 
5% for a confidence level of 95%, then you can be 95% confident that the 
information has an error of 5% or less. 

The Student's "T" distribution is used in these calculations because it improves the 
accuracy for small samples. As the size of the sample increases, the Student's "T" 
distribution approaches the normal distribution. 

The following equation is used to calculate error tolerance: 



error pet. = X 100 

Where: 

Om Mean of the standard deviations. 

t Table entry in Student's "T" table for a given confidence 
level. 

N Number of traces in the measurement. 

P m Mean of the means (i.e., mean sample). 



Examples Consider the following activity measurement report (generated with the commands 

shown): 

display trace depth 512 <RETURN> 
trace counting time <RETURN> 

performance_measurement_initialize addr_ranges <RETURN> 
performance_measurement_run 2 0 <RETURN> 
performance_measurement_end <RETURN> 
!perf32 | more 
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Label 

set_outputs 

Address Range 33D0H thru 3460H 



Memory Activity 



State Percent 


Rel = 


42 . 


, 02 


Abs = 


40 . 


.00 




Mean = 


204 . 


. 80 


Sdv = 


257 . 


. 34 


Time Percent 


Rel = 


42 . 


.18 


Abs = 


40 . 


. 12 


Activity 














State Percent 


Rel = 


40. 


. 93 


Abs = 


40. 


.00 




Mean = 


204 . 


80 


Sdv = 


257. 


.34 


Time Percent 


Rel = 


41 . 


.35 


Abs = 


40. 


. 12 



update_system 

Address Range 31D4H thru 3292H 



Memory Activity 



State 


Percent 


Rel = 


21.01 


Abs = 


20 . 


.00 






Mean = 


102 .40 


Sdv = 


210 . 


. 12 


Time 


Percent 


Rel = 


21.09 


Abs = 


20. 


,06 



Program Activity 



State 


Percent 


Rel = 


20 . 


.47 


Abs = 


20 . 


. 00 






Mean = 


102 . 


.40 


Sdv = 


210 . 


. 12 


Time 


Percent 


Rel = 


20. 


. 67 


Abs = 


20. 


.06 



save_points 

Address Range 34E8H thru 35CCH 



Memory Activity 



State Percent 


Rel = 


7 . 


. 93 


Abs = 


7 . 


. 55 




Mean = 


38. 


65 


Sdv = 


125 . 


. 74 


Time Percent 


Rel = 


9, 


.00 


Abs = 


8. 


,56 


Activity 














State Percent 


Rel = 


7 . 


. 93 


Abs = 


7 . 


. 75 




Mean = 


39. 


. 70 


Sdv = 


127 . 


.76 


Time Percent 


Rel = 


8 . 


98 


Abs = 


8. 


. 71 



strcpy8 

Address Range 2CCCH thru 2D26H 



Memory Activity 



State Percent 


Rel = 


7 . 


. 85 


Abs = 


7 . 


. 47 




Mean = 


38. 


.25 


Sdv = 


118 . 


.20 


Time Percent 


Rel = 


7 . 


.53 


Abs = 


7 . 


.16 


Activity 














State Percent 


Rel = 


9. 


. 98 


Abs = 


9. 


.76 




Mean = 


49. 


. 95 


Sdv = 


153 . 


.80 


Time Percent 


Rel = 


9. 


. 15 


Abs = 


8. 


.88 



get_targets 
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Address Range 329AH thru 3322H 



Memory Activity 



State Percent 


Rel = 


5 . 


.25 


Abs = 


5 




Mean = 


25 . 


. 60 


Sdv = 


114 


Time Percent 


Rel = 


5 . 


.27 


Abs = 


5 


Activity 












State Percent 


Rel = 


5 . 


, 12 


Abs = 


5 




Mean = 


25. 


. 60 


Sdv = 


114 


Time Percent 


Rel = 


5. 


. 17 


Abs = 


5 



. 00 
.49 
.01 



.00 
.49 
.01 



inter rupt_sim 

Address Range 2C22H thru 2CC4H 



Memory Activity 



State Percent 


Rel = 


5 . 


. 25 


Abs = 


5 




Mean = 


25. 


. 60 


Sdv = 


114 


Time Percent 


Rel = 


4 . 


.20 


Abs = 


4 


Activity 












State Percent 


Rel = 


5 . 


. 12 


Abs = 


5 




Mean = 


25 . 


. 60 


Sdv = 


114 


Time Percent 


Rel = 


4 . 


. 12 


Abs = 


4 



. 00 
.49 
.00 



.00 
.49 
.00 



read_conditions 

Address Range 332AH thru 33C8H 



Memory Activity 



State Percent 


Rel = 


5 . 


.25 


Abs = 


5 




Mean = 


25. 


. 60 


Sdv = 


114 


Time Percent 


Rel = 


5 . 


.27 


Abs = 


5 


Activity 












State Percent 


Rel = 


5 . 


. 12 


Abs = 


5 




Mean = 


25. 


. 60 


Sdv = 


114 


Time Percent 


Rel = 


5. 


. 17 


Abs = 


5 



.00 
.49 
.01 



. 00 
.49 
.01 



write_hdwr 

Address Range 3468H thru 34E0H 



Memory Activity 



State Percent 


Rel = 


5. 


.25 


Abs = 


5 




Mean = 


25. 


. 60 


Sdv = 


114 


Time Percent 


Rel = 


5. 


. 27 


Abs = 


5 


Activity 












State Percent 


Rel = 


5 . 


. 12 


Abs = 


5 




Mean = 


25 . 


. 60 


Sdv = 


114 


Time Percent 


Rel = 


5 . 


, 17 


Abs = 


5 



.00 
.49 
.01 



.00 
.49 
.01 



do_sort 

Address Range 3080H thru 3122H 



Memory Activity 
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State Percent 


Rel = 


u . 


.18 


Abs 




u . 


1 S3 




Mean = 


0 . 


. 90 


Sdv 




4 . 




Time Percent 


Rel = 




.19 


Abs 




n 
U . 


1 D 


Program Activity 
















State Percent 


Rel = 


g 


.22 


Abs 




Q 


2 1 




Mean = 


± . 


. 10 


Sdv 




/i 




Time Percent 


Rel = 


n 
u . 


.22 


Abs 




n 


O 1 


combsort 
















Address Range 2E74H thru 




3078H 








Memory Activity 
















State Percent 


Rel = 


u . 


. 00 


Abs 




u . 


. u u 




Mean = 


n 
u . 


.00 


Sdv 




n 
u . 


n n 
. u u 


Time Percent 


Rel = 


n 
u . 


.00 


Abs 




n 
u . 


n n 
. u u 


Program Activity 
















State Percent 


Rel = 


g 


. 00 


Abs 




Q 


. 0 0 




Mean = 


n 
u . 


.00 


Sdv 




n 
u . 


. u u 


Time Percent 


Rel = 


u . 


.00 


Abs 




u . 


n n 
. u u 


gen_ascii_data 
















Address Range 2D2EH thru 




2E6CH 








Memory Activity 
















State Percent 


Rel = 


n 
u . 


.00 


Abs 




n 
u . 


n n 
. u u 




Mean = 


n 
u . 


.00 


Sdv 




n 


n n 
, u u 


Time Percent 


Rel = 


n 


.00 


Abs 




n 


. u u 


Program Activity 
















State Percent 


Rel = 


n 
u . 


.00 


Abs 




n 
u . 


. u u 




Mean = 


n 
u . 


.00 


Sdv 




n 
u . 


n n 
. u u 


Time Percent 


Rel = 


n 
u . 


.00 


Abs 




n 
u . 


n n 
, u u 


graph_data 
















Address Range 35D4H thru 




368CH 








Memory Activity 
















State Percent 


Rel = 


n 
u . 


.00 


Abs 




n 
u . 


n n 
. u u 




Mean = 


n 

U ■ 


.00 


Sdv 




n 
u . 


. u u 


Time Percent 


Rel = 




.00 


Abs 






. u u 


Program Activity 
















State Percent 


Rel = 


0. 


.00 


Abs 




0. 


.00 




Mean = 


0 . 


. 00 


Sdv 




0 . 


. 00 


Time Percent 


Rel = 


0 . 


. 00 


Abs 




0 . 


. 00 


proc_specif ic 
















Address Range 36B8H thru 




36D8H 








Memory Activity 
















State Percent 


Rel = 


0 . 


.00 


Abs 




0. 


.00 




Mean = 


0 . 


. 00 


Sdv 




0. 


.00 


Time Percent 


Rel = 


0. 


.00 


Abs 




0. 


,00 
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Program Activity 

State Percent Rel = 0.00 Abs = 0.00 

Mean = 0.00 Sclv = 0.00 

Time Percent Rel = 0.00 Abs = 0.00 



Graph of 


Memory 


Activity relative state percents 


set_outputs 


42 . 


.02% 


********************* 


update_system 


21 . 


.01% 


*********** 


save_points 


7 . 


. 93% 


* * * * 


strcpy8 


7 . 


. 85% 


* * * * 


get_targets 


5. 


.25% 


* * * 


inter rupt_sim 


5. 


.25% 


* * * 


read_condit ions 


5. 


.25% 


* * * 


write_hdwr 


5. 


.25% 


* * * 



Graph of 


Memory 


Activity relative time percents 


set_outputs 


42 . 


. 18% 


********************* 


update_system 


21 . 


.09% 


*********** 


save_points 


9. 


. 00% 


***** 


strcpy 8 


7 . 


. 53% 


* * * * 


get_targets 


5. 


.27% 


* * * 


interrupt_sim 


4 . 


.20% 


* * 


read_conditions 


5. 


.27% 


* * * 


write_hdwr 


5. 


.27% 


* * * 



Graph of 


Program Act 


ivi 


set_outputs 


40 . 


93% 




update_system 


20. 


47% 




save_points 


7 . 


93% 


* * 


strcpy8 


9. 


98% 


* * 


get_targets 


5. 


12% 


* * 


inter rupt_sim 


5. 


12% 


* * 


read_conditions 


5. 


12% 


* * 


write_hdwr 


5. 


12% 


* * 



t******** 



Graph of 


Program Act 


ivity relative time percents 


set_outputs 


41 . 35% 


********************* 


update_system 


20.67% 


*********** 


save_points 


8 . 98% 


***** 


strcpy 8 


9. 15% 


***** 


get_targets 


5 . 17% 


* * * 


interrupt_sim 


4 . 12% 


* * 


read_conditions 


5 . 17% 


* * * 


write_hdwr 


5 . 17% 


* * * 



Summary Information for 20 traces 



Memory Activity 
State count 

Relative count 9748 

Mean sample 37.49 

Mean Standard Dv 90.26 

95% Confidence 112.72% Error tolerance 
Time count 
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Relative Time - Us 3230.68 



Program Activity 
State count 

Relative count 10007 

Mean sample 38.49 

Mean Standard Dv 93.22 

95% Confidence 113.41% Error tolerance 
Time count 

Relative Time - Us 3295.40 

Absolute Totals 

Absolute count - state 10240 
Absolute count - time - Us 3396.92 

The measurements for each label are printed in descending order according to the 
amount of activity. You can see that the strcpy8 function has the most activity. 
Also, you can see that no activity is recorded for several of the functions. The 
histogram portion of the report compares the activity in the functions that account 
for at least 1% of the activity for all labels defined in the measurement. 
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Duration Performance Measurements 

Duration measurements provide a best-case/worst-case characterization of code 
execution time. These measurements record execution times that fall within a set of 
specified time ranges. The analyzer trace command is set up to store only the entry 
and exit states of the module to be measured (for example, a C function or Pascal 
procedure). The SPMT provides two types of duration measurements: module 
duration, and module usage. 

Module duration measurements record how much time it takes to execute a 
particular code segment (for example, a function in the source file). 

Module usage shows how much of the execution time is spent outside of the 
module (from exit to entry). This measurement gives an indication of how often 
the module is being used. 

When using the SPMT to perform duration measurements, there should be only two 
addresses stored in the trace memory: the entry address, and the exit address. 
Recursion can place several entry addresses before the first exit address, and/or 
several exit addresses before the first entry address. Duration measurements are 
made between the last entry address in a series of entry addresses, and the last exit 
address in a series of exit addresses (see the figure below). All of the entry and exit 
addresses which precede these last addresses are assumed to be unused prefetches, 
and are ignored during time measurements. 



START 

START 

START 

START 

END 

END 

END 

END 

START 

START 

START 

START 

END 

END 



assumed pre 
assumed pre 
assumed pre 
last ENTRY 
assumed pre 
assumed pre 
assumed pre 
last EXIT a 
assumed pre 
assumed pre 
assumed pre 
last ENTRY 
assumed pre 
assumed pre 



fetch 

fetch 

fetch 

address 

fetch 

fetch 

fetch 

ddress 

fetch 

fetch 

fetch 

address 

fetch 

fetch 



Measure duration 



_ Measure duration 



When measuring a recursive function, module duration will be measured between 
the last recursive call and the true end of the recursive execution. This will affect 
the accuracy of the measurement. 
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If a module is entered at the normal point, and then exited by a point other than the 
defined exit point, the entry point will be ignored. It will be judged the same as any 
other unused prefetch, and no time-duration measurement will be made. Its time 
will be included in the measure of time spent outside the procedure or function. 

If a module is exited from the normal point, and then reentered from some other 
point, the exit will also be assumed to be an unused prefetch of the exit state. 

Note that if you are making duration measurements on a function that is recursive, 
or one that has multiple entry and/or exit points, you may wind up with invalid 
information. 

This section describes how to: 

• Set up the trace command for duration measurements. 

• Initialize duration performance measurements. 

• Interpret duration measurement reports. 



To set up the trace command for duration 
measurements 

1 Specify a trace display depth of 5 12. 

2 Trace after and store only funtion start and end addresses. 

For duration measurements, the trace command must be set up to store only the 
entry and exit points of the module of interest. Since the trigger state is always 
stored, you should trigger on the entry or exit points. For example: 

trace after symbol_entry or symbol_exit only 
symbol_entry or symbol_exit counting time <RETURN> 



CAUTION The previous command depends on the generation of correct exit address symbols 

by the software development tools. 
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Or: 

trace after module_name start or module_name end only 
module_name start or module_name end counting time 

<RETURN> 

Where "symbol_entry" and "symbol_exit" are symbols from the user program. Or, 
where "module_name" is the name of a C function or Pascal procedure (and is 
listed as a procedure symbol in the global symbol display). 



Examples To specify a trace display depth of 5 1 2: 

display trace depth 512 <RETURN> 

To set up the trace command for duration measurements on the interrupt_sim 
function: 

trace after interrupt_sim start or interrupt_sim end 
only interrupt_sim start or interrupt_sim end counting 
time <RETURN> 

The trace specification sets up the analyzer to capture only the states that contain 
the start address of the interrupt_sim function or the end address of the 
interrupt_sim function. Since the trigger state is also stored, the analyzer is set up 
to trigger on the entry or exit address of the interrupt_sim function. With these 
states in memory, the analyzer will derive two measurements: time from start to 
end of interrupt_sim, and time from end to start of interrupt_sim. 
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To initialize duration performance measurements 

• Use the performance_measurement_initialize command with the duration 

option. 

After you set up the trace command, you must tell the SPMT the time ranges to be 
used in the duration measurement. This is done by initializing the performance 
measurement. You can initialize the performance measurement in the following 

ways: 

• Initialize with user-defined files. 

• Restore a previous performance measurement (if the emulation system has 
been exited and reentered). 

Initialization with User Defined Ranges 

You can specifically give the SPMT time ranges to use by placing the information 
in a file and entering the file name in the performance_measurement_initialize 
command. 

Time range files may contain comments and time ranges in units of microseconds 
(us), milliseconds (ms), or seconds (s). An example time range file is shown below. 

# Any line which starts with a # is a comment. 

1 us 20 us 

10.1 ms 100 . 6 ms 

3.55 s 6.77 s 

# us microseconds 

# ms milliseconds 

# s seconds 
# 

# The above are the only abbreviations allowed. The space between the number 

# and the units abbreviation is required. 
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When no user defined time range file is specified, the following set of default time 
ranges are used. 

1 us 10 us 
10.1 us 100 us 
100.1 us 500 us 
500.1 us 1 ms 
1.001 ms 5 ms 
5.001 ms 10 ms 
10.1 ms 2 0 ms 

2 0.1 ms 4 0 ms 
4 0.1 ms 8 0 ms 
80.1 ms 160 ms 
160.1 ms 320 ms 
320.1 ms 640 ms 
640.1 ms 1.2 s 

Restoring the Current Measurement 

The performance_measurement_initialize restore command allows you to 
restore old performance measurement data from the perf.out file in the current 
directory. 

If you have not exited and reentered emulation, you can add traces to a performance 
measurement simply by entering another performance_measurement_run 
command. However, if you exit and reenter the emulation system, you must enter 
the performance_measurement initialize restore command before you can add 
traces to a performance measurement. When you restore a performance 
measurement, make sure your current trace command is identical to the command 
used with the restored measurement. 

The restore option checks the emulator software version and will only work if the 
perf.out files you are restoring were made with the same software version as is 
presently running in the emulator. If you ran tests using a former software version 
and saved perf.out files, then updated your software to a new version number, you 
will not be able to restore old perf.out measurement files. 



Examples To initialize the duration measurement: 

p&rformance_measurement_initializ& duration <RETURN> 
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To interpret duration measurement reports 

• View the performance measurement report. 

Duration measurements provide a best-case/worst-case characterization of code 
execution time. These measurements record execution times that fall within a set of 
specified time ranges. The information you will see in duration measurement 
reports is described below. 

Number Of Intervals Number of "from address" and "to address" pairs (after 
prefetch correction). 

Maximum Time The greatest amount of time between the "from address" to the 
"to address". 

Minimum Time The shortest amount of time between the "from address" to the 
"to address". 

Average Time Average time between the "from address" and the "to address". 
The following equation is used to calculate the average time: 

mean = amount °f ^ me f° r a ^ intervals 
number of intervals 
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Standard Deviation Deviation from the mean of time. The following equation 
is used to calculate standard deviation: 



N 



std dev = J jfzrj x 2 Ssumq - N (mean f 



Where: 

N Number of intervals, 

mean Average time. 

Ssumq Sum of squares of time in the intervals. 

Error Tolerance and Confidence Level An approximate error may exist in 
displayed information. Error tolerance for a level of confidence is calculated using 
the mean of the standard deviations and the mean of the means. Error tolerance 
gives an indication of the stability of the information. For example, if the error is 
5% for a confidence level of 95%, then you can be 95% confident that the 
information has an error of 5% or less. 

The Student's "T" distribution is used in these calculations because it improves the 
accuracy for small samples. As the size of the sample increases, the Student's "T" 
distribution approaches the normal distribution. 

The following equation is used to calculate error tolerance: 

O m X t 



error pet. = N x p m X 100 



Where: 

Om Mean of the standard deviations in each time range. 

t Table entry in Student's "T" table for a given confidence 

level. 

N Number of intervals. 
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Mean of the means (i.e., mean of the average times in each 
time range). 



Examples Consider the following duration measurement report (generated with the commands 

shown): 

display trace depth 512 <RETURN> 

trace after interrupt_sim start or interrupt_sim end 
only interrupt_sim start or interrupt_sim end counting 
time <RETURN> 

performance_measurement_initialize duration <RETURN> 
performance_measurement_run 10 <RETURN> 
performance_measurement_end <RETURN> 
!perf32 | more 



Time Interval Profile 



From Address 2C22 

File main (module ) . 11 / users / patw/demo/debug_env/hp64 7 4 6 /ma in . c " 

Symbolic Reference at main . interrupt_sim 
To Address 2CC4 

File main (module ) . " /users /patw/demo/debug_env/hp64 7 4 6 /ma in . c " 

Symbolic Reference at interrupt_sim+A2 
Number of intervals 2550 
Maximum Time 253214.720 us 
Minimum Time 82.560 us 
Avg Time 28014.473 us 



Statistical summary - for 10 traces 

Stdv 58762.63 

95% Confidence 8.14% Error tolerance 





Graph of 


relative percents 


1 us 10 


us 


0 . 


. 00% 




10.1 us 


100 us 


14 . 


. 98% 


******** 


100.1 us 


500 us 


4 . 


. 82% 


*** 


500.1 us 


1 ms 


9. 


. 92% 


***** 


1.001 ms 


5 ms 


30. 


.47% 


kkkkkkkkkkkkkkk 


5.001 ms 


10 ms 


14 . 


. 94% 


kkkkkkkk 


10.1 ms 


20 ms 


0 . 


. 00% 




20.1 ms 


4 0 ms 


9. 


. 80% 


k k k k k 


40.1 ms 


80 ms 


4 . 


. 94% 


k k k 


80.1 ms 


160 ms 


5. 


. 02% 


k k k 


160.1 ms 


320 ms 


5, 


. 10% 


*** 


320 . 1 ms 


640 ms 


0. 


.00% 




640.1 ms 


1.2 s 


0. 


.00% 
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From Address 2CC4 

File main (module ) . " /users /patw/demo/debug_env/hp64 7 4 6 /ma in . c " 

Symbolic Reference at interrupt_sim+A2 
To Address 2C22 

File main (module ) . " / users / patw/demo/debug_env/hp64 7 4 6 /ma in . c 11 

Symbolic Reference at main . interrupt_sim 
Number of intervals 2550 
Maximum Time 79728.640 us 
Minimum Time 50892.800 us 
Avg Time 59438.028 us 



Statistical summary - for 10 traces 

Stdv 13156.24 

95% Confidence 0.86% Error tolerance 



Graph of relative percents 

1 us 10 us 0.00% 

10.1 us 100 us 0.00% 

100.1 us 500 us 0.00% 

500 . 1 us 1 ms 0 . 00% 

1 . 001 ms 5 ms 0 . 00% 

5.001 ms 10 ms 0.00% 

10 . 1 ms 20 ms 0 . 00% 

20 . 1 ms 40 ms 0 . 00% 

40.1 ms 80 ms 100.00% 

80.1 ms 160 ms 0.00% 

160.1 ms 320 ms 0.00% 

320.1 ms 640 ms 0.00% 

640 . 1 ms 1 . 2 s 0 . 00% 



************************************************** 



Two sets of information are given in the duration measurement report: module 
duration and module usage. 

The first set of information in the duration measurement report is the "module 
duration" measurement. The module duration report shows that the amount of time 
it takes for the interrupt_sim function to execute varies from 82.6 microseconds to 
253.2 milliseconds. The average amount of time it takes for the interrupt_sim 
module to execute is roughly 28 milliseconds. 

The second set is the "module usage" measurement. Module usage measurements 
show how much time is spent outside the module of interest; they indicate how 
often the module is used. The information shown in the second part of the duration 
report above shows that the average amout of time spent outside the interrupt_sim 
function is about 59.4 milliseconds. 
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Running Measurements and Creating Reports 

Several performance measurement tasks are the same whether you are making 
activity or duration measurements. 

This section describes how to: 

• Run performance measurements. 

• End performance measurements. 

• Create a performance measurement report. 



To run performance measurements 

• Use the performance_measurement_run command. 

The performance_measurement_run command processes analyzer trace data. 
When you end the performance measurement, this processed data is dumped to the 
binary "perf.out" file in the current directory. The peif32 report generator utility is 
used to read the binary information in the "perf.out" file. 

If the performance_measurement_run command is entered without a count, the 
current trace data is processed. If a count is specified, the current trace command is 
executed consecutively the number of times specified. The data that results from 
each trace command is processed and combined with the existing processed data. 
The STATUS line will say "Processing trace <NO.>" during the run so you will 
know how your measurement is progressing. The only way to stop this series of 
traces is by using <CTRL>c (sig INT). 

The more traces you include in your sample, the more accurate will be your results. 
At least four consecutive traces are required to obtain statistical interpretation of 
activity measurement results. 
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Examples To run the performance measurement, enter the following command: 

p&rformancs_msasurement_run 2 0 <RETURN> 

The command above causes 20 traces to occur. The SPMT processes the trace 
information after each trace, and the number of the trace being processed is shown 
on the status line. 



To end performance measurements 

• Use the performance_measurement_end command. 

The performance_measurement_end command takes the data generated by the 
performance_measurement_run command and places it in a file named perf.out 
in the current directory. If a file named "perf.out" already exists in the current 
directory, it will be overwritten. Therefore, if you wish to save a performance 
measurement, you must rename the perf.out file before performing another 
measurement. 

The performance_measurement_end command does not affect the current 
performance measurement data which exists within the emulation system. In other 
words, you can add more traces later to the existing performance measurement by 
entering another performance_measurement_run command. 

Once you have entered the performance_measurement_end command, you can 
use the perf32 report generator to look at the data saved in the perf.out file. 

Note that the "perf.out" file is a binary file. Do not try to read it with the UNIX 
more or cat commands. The perf32 report generator utility (described in the 
following section) must be used to read the contents of the "perf.out" file. 



Examples To cause the processed trace information to be dumped to the "perf.out" file: 

p&rformancs_msasurement_end <RETURN> 



316 



Chapter 8: Making Software Performance Measurements 
Running Measurements and Creating Reports 



To create a performance measurement report 

• Use the perf32 command at the UNIX prompt. 

The perf32 report generator utility must be used to read the information in the 
"perf.out" file and other files dumped by the SPMT (in other words, renamed 
"perf.out" files). The perf32 utility is run from the UNIX shell. You can fork a 
shell while in the Softkey Interface and run perf32, or you can exit the Softkey 
Interface and run peif32. 

Options to "perf32" 

A default report, containing all performance measurement information, is generated 
when the perD2 command is used without any options. The options available with 
perf32 allow you to limit the information in the generated report. These options 
are described below. 



-h Produce outputs limited to histograms. 

-s Produce a summary limited to the statistical data. 

-p Produce a summary limited to the program activity. 

-m Produce a summary limited to the memory activity. 

-f<file> Produce a report based on the information contained in 

<file> instead of the information contained in perf.out. 



For example, the following commands save the current performance measurement 
information in a file called "perfl .out", and produce a histogram showing only the 
program activity occupied by the functions and variables. 

mv perf.out perfl. out <RETURN> 
perf32 -hpf perfl. out <RETURN> 

Options -h, -s, -p, and -m affect the contents of reports generated for activity 
measurements. These options have no effect on the contents of reports generated 
for duration (time interval) measurements. 
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Examples Now, to generate a report from the "perf.out" file, type the following on the 

command line to fork a shell and run the perf32 utility: 

!perf32 | more 
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The HP 64703 A analyzer provides an external analyzer with 16 external trace 
channels. These trace channels allow you to capture activity on signals external to 
the emulator, typically other target system signals. The external analyzer may be 
configured as an extension to the emulation analyzer, as an independent state 
analyzer, or as an independent timing analyzer. 

When the external analyzer is configured as an independent state analyzer, the 
emulator/analyzer interface does not control the external analyzer. However, you 
can use pod commands to control the independent state analyzer via the terminal 
interface. Refer to the 68302 Emulator Terminal Interface User's Guide for 
information on using the external analyzer when it is configured as an independent 
state analyzer. 

When the external analyzer is configured as an independent timing analyzer, you 
must use a special Timing Analyzer Interface program. Refer to the Timing 
Analyzer Interface User's Guide for information on using the external analyzer 
when it is configured as an independent timing analyzer. 

The tasks you perform with the external analyzer are grouped into the following 
sections: 

• Setting up the external analyzer. 



• Configuring the external analyzer. 
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Setting Up the External Analyzer 

This section assumes you have already connected the external analyzer probe to the 
HP 64700 Card Cage. 

Before you can use the external analyzer, you must: 

• Connect the external analyzer probe to the target system. 

• Specify threshold voltages of external trace signals. 

• Label the external trace signals. 

• Select the external analyzer mode. 
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To connect the external analyzer probe to the 
target system 



1 Assemble the Analyzer Probe. The analyzer probe is a two-piece assembly, consisting of ribbon cable 
and 18 probe wires (16 data channels and the J and K clock inputs) attached to a connector. Either end of 
the ribbon cable may be connected to the 18 wire connector, and the connectors are keyed so they may 
only be attached one way. Align the key of the ribbon cable connector with the slot in the 18 wire 
connector, and firmly press the connectors together. 
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2 Attach grabbers to probe wires. Each of the 18 probe wires has a signal and a ground connection. 
Each probe wire is labeled for easy identification. Thirty-six grabbers are provided for the signal and 
ground connections of each of the 18 probe wires. The signal and ground connections are attached to the 
pin in the grabber handle. 
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CAUTION Turn OFF target system power before connecting analyzer probe wires to the target 

system. The probe grabbers are difficult to handle with precision, and it is 
extremely easy to short the pins of a chip (or other connectors which are close 
together) with the probe wire while trying to connect it. 



3 You can connect the grabbers to pins, connectors, wires, etc., in the target system. Pull the hilt of the 
grabber towards the back of the grabber handle to uncover the wire hook. When the wire hook is around 
the desired pin or connector, release the hilt to allow the grabber spring tension to hold the connection. 
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Configuring the External Analyzer 

After you have assembled the external analyzer probe and connected it to the 
emulator and target system, the next step is to configure the external analyzer. 

The external analyzer is a versatile instrument, and you can configure it to suit your 
needs. For example, you can specify threshold voltage levels on the external 
analyzer channels, and you can operate the external analyzer in several different 
modes. 

The default configuration specifies that the external analyzer is aligned with the 
emulation analyzer. TTL level threshold voltages are defined, as well as an 
external label named "xbits" which contains all 16 channels. 

This section describes how to: 

• Specify whether the emulation emulator/analyzer interface should control the 
external analyzer. 

• Specify the threshold voltages for the external channels. 

• Select the external analyzer mode. 

• Specify the slave clock mode when configured as an independent state 
analyzer. 

• Define labels for the external analyzer channels. 
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To control the external analyzer with the 
emulator/analyzer interface 

1 Enter the modify configuration command. 

2 Answer "yes" to the "Modify external analyzer configuration?" question. 

3 Answer the "Should emulation control the external bits?" question. 

Answer "yes" if the emulation emulator/analyzer interface should control the 
external analyzer. You must answer "yes" to access the remaining external 
analyzer configuration questions. At the end of the configuration process the 
external analyzer mode and threshold voltages will be set; existing labels will be 
deleted, and only the labels specified in response to the questions below will be 
defined. 

Answer "no" if the emulation emulator/analyzer interface shouldn't control the 
external analyzer. If emulation does not control the external bits, the external 
analyzer configuration will not be modified in any way by the emulation interface. 
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To specify the threshold voltage 

1 Enter the modify configuration command. 

2 Answer "yes" to the "Modify external analyzer configuration?" question. 

3 Answer "yes" to the "Should emulation control the external bits?" question. 

4 Answer the "Threshold voltage for bits 0-7 and J clock?" question. 



5 Answer the "Threshold voltage for bits 8-15 and K clock?" question. 

The external analyzer probe signals are divided into two groups: the lower byte 
(channels 0 through 7 and the J clock), and the upper byte (channels 8 through 15 
and the K clock). You can specify a threshold voltage for each of these groups. 

The default threshold voltages are specified as TTL which translates to 1.40 volts. 

Voltages may be in the range from -6.40 volts to 6.35 volts (with a 0.05V 
resolution). You may also specify CMOS (which translates to 2.5 volts), or ECL 
(which translates to -1.3 volts). 
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To specify the external analyzer mode 

1 Enter the modify configuration command. 

2 Answer "yes" to the "Modify external analyzer configuration?" question. 

3 Answer "yes" to the "Should emulation control the external bits?" question. 

4 Answer the "External analyzer mode?" question. 

The default configuration selects the "emulation" external analyzer mode. In this 
mode, you have 16 external trace signals on which data is captured synchronously 
with the emulation clock. 

The external analyzer may also operate as an independent state analyzer, or it may 
operate as an independent timing analyzer if a host computer interface program is 
used. 

Answer "emulation" to select the emulation mode. In this mode, the external 
analyzer becomes an extension of the emulation analyzer. In other words, they 
operate as one analyzer. The external bits are clocked with the emulation clock. 
External labels may be used in trace commands to qualify trigger, storage, prestore, 
or count states. External labels may be viewed in the trace display. 

Answer "state" to select the independent state mode of the external analyzer. The 
external bits are not available for use from the emulation interface. You can, 
however, use pod commands to control the external state analyzer in its 
independent mode. 

Answer "timing" to select the timing mode of the external analyzer. The external 
bits are not available for use from the emulation interface. Because the pod 
commands for the timing analyzer dump information in binary format, you will 
need to use Timing Analyzer Interface, or other interface program, to capture the 
timing analyzer data. 
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To specify the slave clock mode 

1 Enter the modify configuration command. 

2 Answer "yes" to the "Modify external analyzer configuration?" question. 

3 Answer "yes" to the "Should emulation control the external bits?" question. 

4 Answer "state" to the "External analyzer mode?" question. 

5 Answer the "Slave clock mode for external bits?" question. 

There are two modes of demultiplexing that can be set for the 16 channels of the 
external analyzer: mixed clocks and true demultiplexing. 

Answer "off to turn slave clocks OFF. If the slave clock is "off", all 16 external 
bits are clocked with the emulation clock. 

Answer "mixed" to specify the mixed clock demultiplexing mode. In this mode, 
the lower eight external bits (0-7) are latched when the slave clock (as specified by 
your answers to the next four questions) is received. The upper eight bits and the 
latched lower eight are then clocked into the analyzer when the emulation clock is 
received (see the figure below). 
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If no slave clock has appeared since the last master clock, the data on the lower 8 
bits of the pod will be latched at the same time as the upper 8 bits. If more than one 
slave clock has appeared since the last master clock, only the first slave data will be 
available to the analyzer (see the figure below). 
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Answer "demux" to specify the true demultiplexing mode. In this mode, only the 
lower eight external channels (0-7) are used. The slave clock (as specified by your 
answers to the next four questions) latches these bits and the emulation clock 
samples the same channels again. The latched bits show up as bits 0-7 in the trace 
data, and the second sample shows up as bits 8-15 (see the figure below). 
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If no slave clock has appeared since the last master clock, the data on the lower 8 
bits of the pod will be the same as the upper 8 bits. If more than one slave clock 
has appeared since the last master clock, only the first slave data will be available to 
the analyzer. 

6 If the "mixed" or "true demultiplexing" slave clock modes are selected, answer the 
"Edges of J (K,L,M) clock used for slave clock?" questions. 

These four questions are asked when you select either the "mixed" or "demux" 
slave clock mode. They allow you to define the slave clock. You can specify 
rising, falling, both, or neither (none) edges of the J, K, L, and M clocks. When 
several clock edges are specified, any one of the edges clocks the trace. 

Clocks J and K are the external clock inputs of the external analyzer probe. The L 
and M clocks are generated by the emulator. Typically, the L clock is the 
emulation clock derived by the emulator and the M clock is not used. 



To define labels for the external analyzer signals 

1 Enter the modify configuration command. 

2 Answer "yes" to the "Modify external analyzer configuration?" question. 

3 Answer "yes" to the "Should emulation control the external bits?" question. 

4 For each defined external label (there can be up to 8), answer the "name?", "start 
bit?", "width?", and "polarity?" questions. 

You can define up to eight labels for the 16 external data channels in the 
configuration. These external analyzer labels can be used in trace commands, and 
the data associated with these labels can be displayed in the trace list. One external 
analyzer label, "xbits", is defined by the default configuration and is included in the 
default trace list. 

External labels can be defined with bits in the range of 0 through 15. The start bit 
may be in the range 0 through 15, but the width of the label must not cause the label 
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to extend past bit 15. Thus, the sum of the start bit number plus the width must not 
exceed 16. 

The "polarity?" question allows you to specify positive or negative logic for the 
external bits. In other words, positive means high=l, low=0. Negative means 
low=l, high=0. 

Once external labels are defined, they may be used in trace commands to qualify 
events (if the emulation controls the external analyzer). Also, you can modify the 
trace display to include data for the various trace labels. 

Note that the Timing Analyzer Interface does not use the external labels defined in 
the emulator/analyzer interface. You maintain labels for the timing analyzer within 
the Timing Analyzer Interface itself. 
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When HP 64700 Card Cages are connected together via the Coordinated 
Measurement Bus (CMB), you can start and stop up to 32 emulators at the same 
time. 

You can use the analyzer in one HP 64700 to arm (that is, activate) the analyzers in 
other HP 64700 Card Cages or to cause emulator execution in other HP 64700 Card 
Cages to break into the monitor. 

You can use the HP 64700' s BNC connector (labeled TRIGGER IN/OUT on the 
lower left corner of the HP 64700 rear panel) to trigger an external instrument (for 
example, a logic analyzer or oscilloscope) when the analyzer finds its trigger 
condition. Also, you can allow an external instrument to arm the analyzer or break 
emulator execution into the monitor. 

The coordinated measurement tasks you can perform are grouped into the 
following sections: 

• Setting up for coordinated measurements. 

• Starting and stopping multiple emulators. 

• Driving trigger signals to the CMB or BNC. 

• Stopping program execution on trigger signals. 

• Arming analyzers on trigger signals. 



The location of the CMB and BNC connectors on the HP 64700 rear panel is 
shown in the following figure. 



CMB Connector 



BNC Connector 




be 7 DOE 20 



Signal Lines on the CMB 

There are three bi-directional signal lines on the CMB connector on the rear panel 
of the emulator. These CMB signals are: 

TRIGGER The CMB TRIGGER line is low true. This signal can be driven or 
received by any HP 64700 connected to the CMB. This signal can be used to 
trigger an analyzer. It can be used as a break source for the emulator. 

READY The CMB READY line is high true. It is an open collector and performs 
an ANDing of the ready state of enabled emulators on the CMB. Each emulator on 
the CMB releases this line when it is ready to run. This line goes true when all 
enabled emulators are ready to run, providing for a synchronized start. 



337 



When CMB is enabled, each emulator is required to break to background when 
CMB READY goes false, and will wait for CMB READY to go true before 
returning to the run state. When an enabled emulator breaks, it will drive the CMB 
READY false and will hold it false until it is ready to resume running. When an 
emulator is reset, it also drives CMB READY false. 

EXECUTE The CMB EXECUTE line is low true. Any HP 64700 on the CMB 
can drive this line. It serves as a global interrupt and is processed by both the 
emulator and the analyzer. This signal causes an emulator to run from a specified 
address when CMB READY returns true. 

BNC Trigger Signal 

The BNC trigger signal is a positive rising edge TTL level signal. The BNC trigger 
line can be used to either drive or receive an analyzer trigger, or receive a break 
request for the emulator. 

Comparison Between CMB and BNC Triggers The CMB trigger and BNC 
trigger lines have the same logical purpose: to provide a means for connecting the 
internal trigger signals (trigl and trig2) to external instruments. The CMB and 
BNC trigger lines are bi-directional. Either signal may be used directly as a break 
condition. 

The CMB trigger is level-sensitive, while the BNC trigger is edge-sensitive. The 
CMB trigger line puts out a true pulse following receipt of EXECUTE, despite the 
commands used to configure it. This pulse is internally ignored. 

Note that if you use the EXECUTE function, the CMB TRIGGER should not be 
used to trigger external instruments, because a false trigger will be generated when 
EXECUTE is activated. 
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Setting Up for Coordinated Measurements 

This section describes how to: 

• Connect the Coordinated Measurement Bus. 

• Connect the rear panel BNC. 



To connect the Coordinated Measurement Bus 
(CMB) 



Caution Be careful not to confuse the 9-pin connector used for CMB with those used by 

some computer systems for RS-232C communications. Applying RS-232C signals 
to the CMB connector is likely to result in damage to the HP 64700 Card Cage. 



To use the CMB, you will need one CMB cable for the first two emulators and one additional cable for 
every emulator after the first two. The CMB cable is orderable from HP under product number 
HP 64023 A. The cable is four meters long. 

You can build your own compatible CMB cables using standard 9-pin D type subminiature connectors 
and 26 AWG wire. 

Note that Hewlett-Packard does not ensure proper CMB operation if you are using a self -built cable! 
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Number of HP 64700 Series 
Flmiilatfirs 


Maximum Total Length of 
Cable 


Restrictions on the CMB 

V wllllV V L 1 \ / 1 1 


2 to 8 


100 meters 


None. 


9 to 16 


50 meters 


None. 


9 to 16 


100 meters 


Only 8 emulators may have rear 
panel pullups connected. * 


17 to 32 


50 meters 


Only 16 emulators may have rear 
panel pullups connected. * 


* A modification must be performed by your HP Customer Engineer. 
Emulators using the CMB must use background emulation monitors. 

At least 3/4 of the HP 64700-Series emulators connected to the CMB must be powered up before proper 
operation of the entire CMB configuration can be assured. 



To connect to the rear panel BNC 



Caution The BNC line on the HP 64700 accepts input and output of TTL levels only. (TTL 

levels should not be less than 0 volts or greater than 5 volts.) Failure to observe 
these specifications may result in damage to the HP 64700 Card Cage. 
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1 Connect one end of a 50 ohm coaxial cable with male BNC connectors to the HP 64700 BNC 
receptacle and the other end to the appropriate BNC receptacle on the other measuring instrument. 




SIDES OF JACK 



PUSH TOGETHER 
AND TURN UNTIL 
CONNECTORS LOCK 




64700E' j 



The BNC connector is capable of driving TTL level signals into a 50 ohm load. (A positive rising edge is 
the trigger signal.) It requires a driver that can supply at least 4 mA at 2 volts when used as a receiver. 
The BNC connector is configured as an open-emitter structure which allows for multiple drivers to be 
connected. It can be used for cross-triggering between multiple HP 64700Bs when no other 
cross-measurements are needed. The output of the BNC connector is short-circuit protected and is 
protected from TTL level signals when the emulator is powered down. 
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Starting/Stopping Multiple Emulators 

When HP 64700 Card Cages are connected together via the Coordinated 
Measurement Bus (CMB), you can start and stop up to 32 emulators at the same 
time. These are called synchronous measurements. 

This section describes how to: 

• Enable synchronous measurements. 

• Start synchronous measurements. 

• Disable synchronous measurements. 



To enable synchronous measurements 

• Enter the specify run command. 

You can enable the emulator' s interaction with the CMB by using the specify run 
command. When the EXECUTE signal is received, the emulator will run at the 
current program counter address or the address specified in the specify run 
command. 

Note that when the CMB is being actively controlled by another emulator, the step 
command does not work correctly. The emulator may end up running in user code 
(NOT stepping). Disable CMB interaction (see "To disable synchronous 
measurements" below) while stepping the processor. 

Note that enabling CMB interaction does not affect the operation of analyzer 
cross-triggering. 

You can use the specify trace command to specify that an analyzer measurement 
begin upon reception of the CMB EXECUTE signal. 

The trace measurement defined by the specify trace command will be started when 
the EXECUTE signal becomes active. When the trace measurement begins, you 
will see the message "CMB execute; emulation trace started". 
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When you enter a normal trace command, trace at execute is disabled, and the 
analyzer ignores the CMB EXECUTE signal. 



Examples To enable synchronous measurements: 

specify run from le8h <RETURN> 

To trace when synchronous execution begins: 

specify trace after address main <RETURN> 



To start synchronous measurements 

• Enter the cmb_execute command. 

The cmb_execute command will cause the EXECUTE line to be pulsed, thereby 
initiating a synchronous measurement. CMB interaction does not have to be 
enabled in order to use either of these commands. (When you enable CMB 
interaction, you only specify how the emulator will react to the CMB EXECUTE 
signal.) 

All emulators whose CMB interaction is enabled will break into the monitor when 
any one of those emulators breaks into its monitor. 



To disable synchronous measurements 

• Enter the specify run disable command. 

You can disable the emulator's interaction with the CMB by using the specify run 
disable command. When interaction is disabled, the emulator ignores the CMB 
EXECUTE and READY lines. 
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Using Trigger Signals 



The HP 64700 contains two internal lines, trigl and trig2, over which trigger 
signals can pass from the emulator or analyzer to other HP 64700s on the 
Coordinated Measurement Bus (CMB) or other instruments connected to the BNC 
connector. 

You can configure the internal lines to make connections between the emulator, 
analyzer, external analyzer (if its configured as an independent state or timing 
analyzer), CMB connector, or BNC connector. Measurements that depend on these 
connections are called interactive measurements or coordinated measurements. 

To configure the internal trigl and trig2 lines, you must enter the modify 
configuration command and then answer "yes" to the "Modify interactive 
measurement specification?" question. When you do this, the following display 
appears. 



Interactive Measurement Specification 
BNC <<-??->> — \ BNC <<-??->> — \ 



CMBT <<-??->> — 

Emulator << 

Analyzer >> / 



Trigl 



CMBT <<-??->> — 

Emulator <<-?? — 

Analyzer <<-??->> — 

External Analyzer <<-??->> / 



Tr i g2 



NOTES: 

1. The connections marked "??" are set up here in configuration. 

2. drive = >> receive = << (The display won't change, houuever. ) 

3. The External Analyzer question is only asked when the External Analyzer 
mode is state or timing. 



This display illustrates the possible connections between the internal lines (trigl 
and trig2) and the emulator, analyzer, and external devices. 

Note that the "External Analyzer" option for "Trig2" only appears if you have 
selected "state" or "timing" for the external analyzer mode. 

Notice that the analyzer always drives trigl, and the emulator always receives trigl. 
This provides for the break_on_trigger syntax of the trace command. 
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You can use the trig 1 or trig2 line to make a connection between the analyzer and 
the CMB connector or BNC connector so that, when the analyzer finds its trigger 
condition, a trigger signal is driven on the HP 64700' s Coordinated Measurement 
Bus (CMB) or BNC connector. This can also be done for the external analyzer 
when it is configured as an independent state or timing analyzer. 

You can use the trig 1 or trig2 line to make a connection between the emulator break 
input and the CMB connector, BNC connector, analyzer, (or external analyzer 
when configured as an independent state or timing analyzer) so that program 
execution can break when a trigger signal is received from the CMB, BNC, or 
analyzer. 

You can use the trig2 line to make a connection between the analyzer and the CMB 
connector or BNC connector so that the analyzer can be armed (that is, enabled) 
when a trigger signal is received from the CMB or BNC connector. This can also 
be done for the external analyzer when it is configured as an independent state or 
timing analyzer. 

You can use the trig 1 and trig2 lines to make several type of connections at the 
same time. For example, when the analyzer finds its trigger condition, a signal is 
driven on the trigl line. This signal may be used to stop user program execution, 
but the trigger signal may also be driven on the CMB and BNC connectors. 

Also, it's possible for signals to be driven and received on the CMB or BNC 
connectors. So, for example, while the analyzer's trigger signal can be driven on 
the CMB and BNC connectors, signals can also be received from the CMB and 
BNC connectors and used to stop user program execution. In this case, the 
emulator will break into the monitor on either the analyzer trigger or on the 
reception of a trigger signal from the CMB or BNC. 

You can disable connections made by the internal trigl and trig2 lines by 
answering "neither" or "no" to the appropriate interactive measurement 
configuration question. 
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Using Trigger Signals 

This section shows you how to: 

• Drive the emulation analyzer trigger signal to the CMB. 

• Drive the emulation analyzer trigger signal to the BNC connector. 

• Drive the external analyzer trigger signal to the CMB. 

• Drive the external analyzer trigger signal to the BNC connector. 

• Break emulator execution on signal from CMB. 

• Break emulator execution on signal from BNC. 

• Break emulator execution on external analyzer trigger. 

• Arm the emulation analyzer on signal from CMB. 

• Arm the emulation analyzer on signal from BNC. 

• Arm the emulation analyzer on external analyzer trigger. 

• Arm the external analyzer on signal from CMB. 

• Arm the external analyzer on signal from BNC. 

• Arm the external analyzer on emulation analyzer trigger. 



To drive the emulation analyzer trigger signal to 
the CMB 

1 Enter the modify configuration command. 

2 Answer "yes" to the "Modify interactive measurement specification?" question. 

3 Answer "receive" to the "Should CMBT drive or receive Trigl?" question. 

You could also drive the emulation analyzer trigger to the CMB over the trig2 
internal line by specifying that the CMBT should receive trig2 and that the 
emulation analyzer should drive trig2. 
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To drive the emulation analyzer trigger signal to 
the BNC connector 

1 Enter the modify configuration command. 

2 Answer "yes" to the "Modify interactive measurement specification?" question. 

3 Answer "receive" to the "Should BNC drive or receive Trigl?" question. 

You could also drive the emulation analyzer trigger to the BNC over the trig2 
internal line by specifying that the BNC should receive trig2 and that the emulation 
analyzer should drive trig2. 



To drive the external analyzer trigger signal to 
the CMB 

1 Enter the modify configuration command. 

2 Answer "yes" to the "Modify interactive measurement specification?" question. 

3 Answer "receive" to the "Should CMBT drive or receive Trig2?" question. 

4 Answer "drive" to the "Should External Analyzer drive or receive Trig2?" question. 
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To drive the external analyzer trigger signal to 
the BNC connector 

1 Enter the modify configuration command. 

2 Answer "yes" to the "Modify interactive measurement specification?" question. 

3 Answer "receive" to the "Should BNC drive or receive Trig2?" question. 

4 Answer "drive" to the "Should External Analyzer drive or receive Trig2?" question. 



To break emulator execution on signal from CMB 

1 Enter the modify configuration command. 

2 Answer "yes" to the "Modify interactive measurement specification?" question. 

3 Answer "drive" to the "Should CMBT drive or receive Trigl?" question. 

You could also break emulator execution on a trigger signal from the CMB over the 
trig2 internal line by specifying that the CMB should drive trig2 and that the 
emulator break should receive trig2. 
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To break emulator execution on signal from BNC 

1 Enter the modify configuration command. 

2 Answer "yes" to the "Modify interactive measurement specification?" question. 

3 Answer "drive" to the "Should BNC drive or receive Trigl?" question. 

You could also break emulator execution on a trigger signal from the BNC over the 
trig2 internal line by specifying that the BNC should drive trig2 and that the 
emulator break should receive trig2. 



To break emulator execution on external analyzer 
trigger 

1 Enter the modify configuration command. 

2 Answer "yes" to the "Modify interactive measurement specification?" question. 

3 Answer "yes" to the "Should Emulator break receive Trig2?" question. 

4 Answer "drive" to the "Should External Analyzer drive or receive Trig2?" question. 

When an emulator break occurs due to the analyzer trigger, the analyzer will stop 
driving the internal signal that caused the break. Therefore, if trig2 is used both to 
break and to drive the CMB TRIGGER (for example), TRIGGER will go true 
when the trigger is found and then will go false after the emulator breaks. 
However, if trigl is used to cause the break and trig2 is used to drive the CMB 
TRIGGER, TRIGGER will stay true until the trace is halted or until the next trace 
starts. 
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To arm the emulation analyzer on signal from 
CMB 

1 Enter the modify configuration command. 

2 Answer "yes" to the "Modify interactive measurement specification?" question. 

3 Answer "drive" to the "Should CMBT drive or receive Trig2?" question. 

4 Answer "receive" to the "Should Analyzer drive or receive Trig2?" question. 

5 Use the arm_trig2 option to the trace command. 



To arm the emulation analyzer on signal from 
BNC 

1 Enter the modify configuration command. 

2 Answer "yes" to the "Modify interactive measurement specification?" question. 

3 Answer "drive" to the "Should BNC drive or receive Trig2?" question. 

4 Answer "receive" to the "Should Analyzer drive or receive Trig2?" question. 

5 Use the arm_trig2 option to the trace command. 
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To arm the emulation analyzer on external 
analyzer trigger 

1 Enter the modify configuration command. 

2 Answer "yes" to the "Modify interactive measurement specification?" question. 

3 Answer "receive" to the "Should Analyzer drive or receive Trig2?" question. 

4 Answer "drive" to the "Should External Analyzer drive or receive Trig2?" question. 

5 Use the arm_trig2 option to the trace command. 



To arm the external analyzer on signal from CMB 

1 Enter the modify configuration command. 

2 Answer "yes" to the "Modify interactive measurement specification?" question. 

3 Answer "drive" to the "Should CMBT drive or receive Trig2?" question. 

4 Answer "receive" to the "Should External Analyzer drive or receive Trig2?" 
question. 
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To arm the external analyzer on signal from BNC 

1 Enter the modify configuration command. 

2 Answer "yes" to the "Modify interactive measurement specification?" question. 

3 Answer "drive" to the "Should BNC drive or receive Trig2?" question. 

4 Answer "receive" to the "Should External Analyzer drive or receive Trig2?" 
question. 



To arm the external analyzer on emulation 
analyzer trigger 

1 Enter the modify configuration command. 

2 Answer "yes" to the "Modify interactive measurement specification?" question. 

3 Answer "drive" to the "Should Analyzer drive or receive Trig2?" question. 

4 Answer "receive" to the "Should External Analyzer drive or receive Trig2?" 
question. 
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The Graphical User Interface is an X Window System application which means it is 
a client in the X Window System client-server model. 

The X server is a program that controls all access to input devices (typically a 
mouse and a keyboard) and all output devices (typically a display screen). It is an 
interface between application programs you run on your system and the system 
input and output devices. 

An X resource controls an element of appearance or behavior in an X application. 
For example, in the graphical interface, one resource controls the text in action key 
pushbuttons as well as the action performed when the pushbutton is clicked. 

By modifying resource settings, you can change the appearance or behavior of 
certain elements in the graphical interface. 

When the graphical interface starts up, it reads resource specifications from a set of 
configuration files. Resources specifications in later files override those in earlier 
files. Files are read in the following order: 

1 The application defaults file. For example, 
/usr/lib/Xl l/app-defaults/HP64_Softkey in HP-UX or 
/usr/openwin/lib/Xl l/app-defaults/HP64_Softkey in SunOS. 

2 The $XAPPLRESDIR/HP64_Softkey file. (The XAPPLRESDIR environment 
variable defines a directory containing system-wide custom application 
defaults.) 

3 The server' s RESOURCE_MANAGER property. (The xrdb command loads 
user-defined resource specifications into the RESOURCE_MANAGER 
property.) 

If no RESOURCE_MANAGER property exists, user defined resource settings 
are read from the $HOME/.Xdefaults file. 

4 The file named by the XENVIRONMENT environment variable. 

If the XENVIRONMENT variable is not set, the $HOME/.Xdefaults-/zo.sf file 
(typically containing resource specifications for a specific remote host) is read. 
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5 Resource specifications included in the command line with the -xrm option. 

6 System scheme files in directory $HP64000/lib/Xl l/HP64_schemes. 

7 System-wide custom scheme files located in directory 
$XAPPLRESDIR/HP64_schemes. 

8 User-defined scheme files located in directory $HOME/.HP64_schemes (note 
the dot in the directory name). 

Scheme files group resource specifications for different displays, computing 
environments, and languages. 

This chapter shows you how to: 

• Modify the Graphical User Interface resources. 

• Use customized scheme files. 

• Set up custom action keys. 

• Set initial recall buffer values. 

• Set up demos or tutorials. 

Refer to the "X Resources and the Graphical Interface" section in the "Concepts" 
chapter for more detailed information. 
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To modify the Graphical User Interface resources 



You can customize the appearance of an X Windows application by modifying its 
X resources. The following tables describe some of the commonly modified 
application resources. 



Application Resources for Schemes 


Resource 


Values 


Description 


HP64_Softkey.platformScheme 


HP-UX 

SunOS 

(custom) 


Names the subdirectory for platform 
specific schemes. This resource should be 
set to the platform on which the X server is 
running (and displaying the Graphical User 
Interface) if it is different than the platform 
where the application is running. 


HP64_Softkey.colorScheme 


BW 

Color 

(custom) 


Names the color scheme file. 


HP64_Softkey.sizeScheme 


Small 
Large 
(custom) 


Names the size scheme file which defines 
the fonts and the spacing used. 


HP64_Softkey.labelScheme 


Label 

$LANG 

(custom) 


Names to use for labels and button text. 
The default uses the $LANG environment 
variable if it is set and if a scheme file 
named Softkey.$LANG exists in one of the 
directories searched for scheme files; 
otherwise, the default is Label. 


HP64_Softkey.inputScheme 


Input 

(custom) 


Specifies mouse and keyboard operation. 
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Commonly Modified Application Resources 


Resource 


Values 


Description 


HP64_Softkey.lines 


24 

(min. 18) 


Specifies the number of lines in the main 
display area. 


HP64_Softkey .columns 


100 

(min. 80) 


Specifies the number of columns, in 
characters, in the main display area. 


HP64_Softkey.enableCmdline 


True 
False 


Specifies whether the command line area is 
displayed when you initially enter the 
Graphical User Interface. 


*editFile 


(example) vi 

%s 


Specifies the command used to edit files. 


*editFileLine 


(example) vi 
+%d %s 


Specifies the command used to edit a file at 
a certain line number. 


*<proc>*actionKeysSub.keyDefs 


(paired list 
of strings) 


Specifies the text that should appear on the 
action key push buttons and the commands 
that should be executed in the command line 
area when the action key is pushed. Refer 
to the "To set up custom action keys" 
section for more information. 


*<proc>*dirSelectSub.entries 


(list of 
strings) 


Specifies the initial values that are placed in 
the File— ^Context— ^Directory popup recall 
buffer. Refer to the "To set initial recall 
buffer values" section for more information. 


*<proc>*recallSub.entries 


(list of 
strings) 


Specifies the initial values that are placed in 
the entry buffer (labeled "():"). Refer to the 
"To set initial recall buffer values" section 
for more information. 
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The following steps show you how to modify the Graphical User Interface's X 
resources. 

1 Copy part or all of the HP64_Softkey application defaults file to a temporary file. 

The HP64_Softkey file contains the default definitions for the graphical interface 
application's X resources. 

For example, on an HP 9000 computer you can use the following command to copy 
the complete HP64_Softkey file to HP64_Softkey.tmp (note that the HP64_Softkey 
file is several hundred lines long): 

cp /usr/lib/Xll/app-defaults/HP64_Softkey HP64_Softkey.tmp 

NOTE: The HP64_Softkey application defaults file is re-created each time 
Graphical User Interface software is installed or updated. You can use the UNIX 
diff command to check for differences between the new HP64_Softkey application 
defaults file and the old application defaults file that is saved as 
$HP64000/lib/Xll/HP64_schemes/old/HP64_Softkey. 

2 Modify the temporary file. 

Modify the resource that defines the behavior or appearance that you wish to 
change. 

For example, to change the number of lines in the main display area to 36: 
vi HP64_Softkey.tmp 

Search for the string "HP64_Softkey.lines". You should see lines similar to the 
following. 



! The lines and columns set the vertical and horizontal dimensions of the 

! main display area in characters, respectively. Minimum values are 18 lines 

! and 80 columns. These minimums are silently enforced. 

! Note: The application cannot be resized by using the window manager. 

!HP64_Softkey. lines: 24 
!HP64_Softkey. columns: 85 
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Edit the line containing "HP64_Softkey.lines" so that it is uncommented and is set 
to the new value: 



! The lines and columns set the vertical and horizontal dimensions of the 

! main display area in characters, respectively. Minimum values are 18 lines 

! and 80 columns. These minimums are silently enforced. 

! Note: The application cannot be resized by using the window manager. 

HP64_Softkey. lines : 36 
!HP64_Softkey. columns: 85 

Save your changes and exit the editor. 

3 If the RESOURCEJVIANAGER property exists (as is the case with HP VUE — if 
you're not sure, you can check by entering the xrdb -query command), use the 
xrdb command to add the resources to the RESOURCE_MANAGER property. For 
example: 

xrdb -merge -nocpp HP64_Softkey.tmp 

Otherwise, if the RESOURCE_MANAGER property does not exist, append the 
temporary file to your $HOME/.Xdefaults file. For example: 

cat HP64_Softkey.tmp » $HOME/.Xdefaults 

4 Remove the temporary file. 

5 Start or restart the Graphical User Interface. 

After you have completed the above steps, you must either start, or restart by 
exiting and starting again, the Graphical User Interface. Starting and exiting the 
Graphical User Interface is described in the "Starting and Exiting HP 64700 
Interfaces" chapter. 
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To use customized scheme files 

Scheme files are used to set platform specific resources that deal with color, fonts 
and sizes, mouse and keyboard operation, and labels and titles. You can create and 
use customized scheme files by following these steps. 

1 Create the $HOME/.HP64_schemes/<platform> directory. 
For example: 

mkdir $HOME/.HP64_schemes 
mkdir $HOME/.HP64_schemes/HP-UX 

2 Copy the scheme file to be modified to the $HOME/.HP64_schemes/<platform> 
directory. 

Label scheme files are not platform specific; therefore, they should be placed in the 
$HOME/.HP64_schemes directory. All other scheme files should be placed in the 
$HOME/.HP64_schemes/<platform> directory. 

For example: 

cp$HP64000/lib/Xll/HP64_schemes/HP-UX/Softkey.Color 
$HOME/.HP64_schemes/HP-UX/Softkey.MyColor 

Note that if your custom scheme file has the same name as the default scheme file, 
the load order requires resources in the custom file to explicitly override resources 
in the default file. 

3 Modify the $HOME/.HP64_schemes/<platform>/Softkey.<scheme> file. 
For example, you could modify the 

"$HOME/.HP64_schemes/HP-UX/Softkey.MyColor" file to change the defined 
foreground and background colors. Also, since the scheme file name is different 
than the default, you could comment out various resource settings to cause general 
foreground and background color definitions to apply to the Graphical User 
Interface. At least one resource must be defined in your color scheme file for it to 
be recognized. 
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4 If your custom scheme file has a different name than the default, you must modify 
the scheme resource definitions. 

The Graphical User Interface application defaults file contains resources that 
specify which scheme files are used. If your custom scheme files are named 
differendy than the default scheme files, you must modify these resource settings so 
that your customized scheme files are used instead of the default scheme files. 

For example, to use the "$HOME/.HP64_schemes/HP-UX/Softkey.MyColor" color 
scheme file you would set the "HP64_Softkey.colorScheme" resource to 
"MyColor": 

HP64_Sof tkey . color Scheme : MyColor 

Refer to the previous "To customize Graphical User Interface resources" section for 
more detailed information on modifying resources. 
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To set up custom action keys 

• Modify the "actionKeysSub.keyDefs" resource. 

The "actionKeysSub.keyDefs" resource defines a list of paired strings. The first 
string defines the text that should appear on the action key pushbutton. The second 
string defines the command that should be sent to the command line area and 
executed when the action key is pushed. 

A pair of parentheses (with no spaces, that is "()") can be used in the command 
definition to indicate that text from the entry buffer should replace the parentheses 
when the command is executed. 

Action keys that use the entry buffer should always include the entry buffer 
symbol, "( )", in the action key label as a visual cue to remind you to place 
information in the entry buffer before clicking the action key. 

Shell commands can be executed by using an exclamation point prefix. A second 
exclamation point ends the command string and allows additional options on the 
command line. 

Also, command files can be executed by placing the name of the file in the 
command definition. 

Finally, an empty action ("") means to repeat the previous operation, whether it 
came from a pulldown, a dialog, a popup, or another action key. 



Examples To set up custom action keys when the graphical interface is used with 68302 

emulators, modify the "*m68302*actionKeysSub.keyDefs" resource: 

*m68302*actionKeysSub.keyDefs: \ 

"Make" "cd /users /pro ject2 / 68302 ; !make! in_browser" \ 

"Load Pgm" "load configuration config.EA; load program2" \ 

"Run Pgm" "run from reset" \ 

"Trace after ( )" "trace after (); display trace" \ 

"Step Source" "set source on; display memory mnemonic; step source" \ 

"Again" "" 



Refer to the previous "To modify Graphical User Interface resources" section for 
more detailed information on modifying resources. 
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To set initial recall buffer values 

• Modify the "entries" resource for the particular recall buffer. 

There are six popup recall buffers present in the Graphical User Interface. The 
resources for these popup recall buffers are listed in the following table. 



The window manager resource "*transientDecoration" controls the borders around 
dialog box windows. The most natural setting for this resource is "title." 



Popup Recall Buffer Resources 


Recall Popup 


Resources 


Description 


File— ^Context— ^Directory ... 


*dirSelect.textColumns 

*dirSelect.listVisibleItemCount 

*dirSelectSub.entries 


The default number of text 
columns in the popup is 50. 

The default number of visible 
lines in the popup is 12. 

The "entries" resource is 
defined as a list of strings (see 
the following example). 

Up to 40 unique values are 
saved in each of the recall 
buffers (as specified by the 
resource settings 
"*XcRecall.maxDepth: 40" and 
"*XcRecall.onlyUnique: True"). 


File— ^Context— ^Symbols ... 


*symSelect.textColumns 

*symSelect.listVisibleItemCount 

*symSelectSub.entries 


Trace— >Trace Spec ... 


* modtrace. textColumns 

*modtrace.listVisibleItemCount 

*modtraceSub.entries 


Entry Buffer (): 


*recall.textColumns 

*recall.listVisibleItemCount 

*recallSub.entries 


Command Line command 
recall 


*recallCmd.textColumns 

*recallCmd.listVisibleItemCount 

*recallCmdSub.entries 


Command Line pod/simio 
recall 


*recallKbd.textColumns 
*recallKbd.listVisibleItemCount 
*recallKbdSub .entries 
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Examples To set the initial values for the directory selection dialog box when the Graphical 

User Interface is used with 68302 emulators, modify the 
"*m68302*dirSelectSub.entries" resource: 

*m68302 *dirSelect Sub . entries : \ 
"$HOME" \ 
" . . " \ 

"/users/pro jectl" \ 
"/users /pro ject2/68302" 

Refer to the previous "To modify the Graphical User Interface resources" section 
for more detailed information on modifying resources. 
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To set up demos or tutorials 



You can add demos or tutorials to the Graphical User Interface by modifying the 
resources described in the following tables. 



Demo Related Component Resources 


Resource 


Value 


Description 


*enableDemo 


False 
True 


Specifies whether Help— >Demo 
appears in the pulldown menu. 


*demoPopupSub.indexFile 


./Xdemo/Index-topics 


Specifies the file containing the list 
of topic and file pairs. 


*demoPopup.textColumns 


30 


Specifies the width, in characters, 
of the of the demo topic list popup. 


*demoPopup.listVisibleItemCount 


10 


Specifies the length, in lines, of the 
demo topic list popup. 


*demoTopic 


About demos 


Specifies the default topic in the 
demo popup selection buffer. 
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Tutorial Related Component Resources 


Resource 


Value 


Description 


*enableTutorial 


False 
True 


Specifies whether 

Help— ^Tutorial appears in the 

pulldown menu. 


*tutorialPopupSub.indexFile 


./Xtutorial/Index-topics 


Specifies the file containing the 
list of topic and file pairs. 


*tutorialPopup.textColumns 


30 


Specifies the width, in 
characters, of the of the tutorial 
topic list popup. 


*tutorialPopup.listVisibleItemCount 


10 


Specifies the length, in lines, of 
the tutorial topic list popup. 


*tutorialTopic 


About tutorials 


Specifies the default topic in the 
tutorial popup selection buffer. 



The mechanism for providing demos and tutorials in the graphical interface is 
identical. The following steps show you how to set up demos or tutorials in the 
Graphical User Interface. 

1 Create the demo or tutorial topic files and the associated command files. 

Topic files are simply ASCII text files. You can use "M" to produce inverse video 
in the text, "\U" to produce underlining in the text, and "\N" to restore normal text. 

Command files are executed when the "Press to perform demo (or tutorial)" button 
(in the topic popup dialog) is pushed. A command file must have the same name as 
the topic file with ".cmd" appended. Also, a command file must be in the same 
directory as the associated topic file. 
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2 Create the demo or tutorial index file. 

Each line in the index file contains first a quoted string that is the name of the topic 
which appears in the index popup and second the name of the file that is raised 
when the topic is selected. For example: 

"About demos" /users /guest /gui_demos /general 

"Loading programs" /users /guest /gui_demos /loadprog 
"Running programs" /users/guest/gui_demos/runprog 

You can use absolute paths (for example, /users/guest/topic 1), paths relative to the 
directory in which the interface was started (for example, mydir/topic2), or paths 
relative to the product directory (for example, ./Xdemo/general where the product 
directory is something like $HP64000/inst/emul/64746A). 

3 Set the "*enableDemo" or "*enableTutorial" resource to "True". 

4 Define the demo index file by setting the "*demoPopupSub.indexFile" or 
" *tutorialPopupSub.indexFile" resource. 

For example: 

*demoPopupSub . indexFile : /users /guest /gui_demos /index 

You can use absolute paths (for example, /users/guest/index), paths relative to the 
directory in which the interface was started (for example, mydir/indexfile), or paths 
relative to the product directory (for example, ./Xdemo/Index-topics where the 
product directory is something like $HP64000/inst/emul/64746A). 

5 If you wish to define a default topic to be selected, set the "*demo Topic" or 
"*tutorialTopic" resource to the topic string. 

For example: 

*demoTopic: "About demos" 

Refer to the previous "To customize Graphical User Interface resources" section for 
more detailed information on modifying resources. 
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Emulator/Analyzer Interface Commands 



This chapter describes the emulator/analyzer interface commands in alphabetical 
order. First, the syntax conventions are described and the commands are 
summarized. 

How Pulldown Menus Map to the Command Line 

The following table shows the items available in the pulldown menus and the 
command line commands to which they map. 
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Pulldown 



File— ^Context— ^Directory 
File->Context->Symbols 
File->Load->Emulator Config 
File— >Load— ^Executable 
File— >Load— ^Program Only 
File->Load->Symbols Only 
File->Store->Trace Data 
File->Store->Trace Spec 
File->Store->BBA Data 
File->Copy->Display 
File->Copy->Memory 
File->Copy->Data Values 
File->Copy->Trace 
File— >Copy— ^Registers 
File— >Copy— ^Breakpoints 
File->Copy->Status 
File->Copy->Global Symbols 
File->Copy->Local Symbols () 
File— >Copy— >Pod Commands 
File->Copy->Error Log 
File->Copy->Event Log 
File->Log->Playback 
File->Log->Record 
File->Log->Stop 

File->Emul700->High-Level Debugger 
File— >Emul700— ^Performance Analyzer 
File->Emul700->Emulator/Analyzer 
File->Emul700->Timing Analyzer 
File->Edit->File 
File->Edit->At () Location 
File->Edit->At PC Location 
File->Term 

File— >Exit— ^Window (save session) 

File— >Exit— ^Locked (all windows, save session) 

File— >Exit— ^Released (all windows, release 

emulator) 



Command Line 

cd 

cws 

load configuration 

load <abs_file> 

load <abs_file> nosymbols 

load symbols 

store trace 

store trace_spec 

bbaunload 

copy display to 

copy memory to 

copy data to 

copy trace to 

copy registers to 

copy software_breakpoints to 

copy status to 

copy global_symbols to 

copy local_symbols_in -SYMB- to 

copy pod_command to 

copy error_log to 

copy event_log to 

<command file> 

log_commands to 

log_commands off 

N/A 

N/A 

N/A 

N/A 

! vi <file> ! no_prompt_before_exit 

! vi +<line> <file> ! no_prompt_before_exit 

! vi +<line> <file> ! no_prompt_before_exit 

end 

end locked 

end release_system 
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Display— ^Context 


pwd, pws 


Display— ^Memory 


display memory 


Display— ^Memory— ^Mnemonic () 


display memory — EXPR— mnemonic 


Display— ^Memory— ^Mnemonic at PC 


display memory mnemonic at_pc 


Display— ^Memory— ^Mnemonic Previous 


display memory mnemonic previous_display 


Display— ^Memory— >Hex ()— kbytes 


display memory -EXPR- blocked bytes 


Display— ^Memory— >Hex ()— swords 


display memory —EXPR— blocked words 


Display— ^Memory— >Hex ()— >long 


display memory —EXPR— blocked long 


Display— ^Memory— >Real ()— >short 


display memory -EXPR- real short 


Display— ^Memory— >Real ()— >long 


display memory —EXPR— real long 


Display— ^Memory— >At () 


display memory — EXPR— 


Display— ^Memory— ^Repetitively 


display memory repetitively 


Display— >Data Values 


display data 


Display— >Data Values— >New ()— ><type> 


display data -EXPR— <type> 


Display— >Data Values— >Add ()— ><type> 


display data, -EXPR- <type> 


Display— >Trace 


display trace 


1 1 in [ji <i \ rjvegis lers ?v.ciass.> 


uispiay legisLeis <^ciass;> 




Uispiay S01lWaie_L)ieaRp0111LS 


Dif nl o i r \ vf nf iif 

ivispidy ?o uuus 


uispiay SlalUS 


Display— ^Simulated IO 


display simulated io 


Display— ^Global Symbols 


display global_symbols 


Display— >Local Symbols () 


display local_symbols_in — SYMB— 


Display— >Pod Commands 


display pod_command 


Display— >Error Log 


display error_log 


Display— >Event Log 


display event_log 


Modify— ^Emulator Config 


modify configuration 


Modify— ^Memory 


modify memory 


Modify-^Memory at () 


modify memory — EXPR- 


Modify— ^Register 


modify register 
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riuiuown 


■ nmm * i n /"I 1 ■ n i\ 

VOII1IIKUH1 l^lllL 


Execution— >Run— >from PC 


run 


Execution— >Run— >from () 


run from —EXPR— 


Execution— >Run— >from Transfer Address 


run from transfer_address 


Execution— >Run— >from Reset 


run from reset 


Execution— >Run— mntil () 


run until -EXPR- 


Execution— >Step Source— >from PC 


step source 


ILXcCUllUIl rolcp kjOUICc 711 UII1 y) 


ctpti cnnrr'P trr\m R YPP 


n-xccuiioii roicp ouurtc 7iroin irdiiaicr 


c t c 1 1" \i 1 i \~i \ n"\ trine I \~ < i / 1 j \ t~(^ c c 

siep source iroiii Lidiisiei_duuiess 


A f 1 f 1 1*1 » W 




IV vi> /*i ■ i it\n \vtf»r* Tucf r*ii/*f irm ifi*r*in 1^1 

ILALLLllllHl 7ult|J 111.M1 U1.11U11 71111111 I 


step 


FYPPiitSnn ^Slfpn Tricfi*iiptSrin ^fWi iti (\ 

IJiACtUUUll ?OlC|J 111511 U^llUll 711U111 \J 


sten from --FXPR — 


ILXcCUllUIl 7olcp lllali UC11U11 71IU1I1 Xltlllalcl 


siep Hum Lioiisiei auuiess 


A f\ f\ race 




n-xccuiion 7i>rt;dK 


break 


Exe cu tion— >Res et 


reset 


Breakpoints— >Display 


display software_breakpoints 


Breakpoints— >Enable 


modify software_breakpoints enable/disable 


Breakpoints— >Permanent () 


modify software_breakpoints set — EXPR- 




permanent 


Breakpoints— >Temporary () 


modify software_breakpoints set — EXPR- 




temporary 


Breakpoints— >Set All 


modify software_breakpoints set 


Breakpoints— >Clear () 


modify software_breakpoints clear —EXPR— 


Breakpoints— >Clear All 


modify software_breakpoints clear 
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Pi 1 1 1 H n wn 

I II 1 1 HI J VV 11 


f\ iti iti ti n H T i ii p 

\_.T/lllllltllltT X^llll- 


Trace— ^Display 


display trace 


Trace— ^Display Options 


display trace 


Trace— >Trace Spec 


N/A (browses recall buffer for trace commands) 


Trace— >After () 


trace after STATE 


Trace-^Before () 


trace before STATE 


Trace-^About () 


trace about STATE 


Trace->Only () 


trace only STATE 


Trace— >Only () Prestore 


trace only STATE prestore anything 


Trace— >Again 


trace again 


Trace— ^Repetitively 


<previous trace spec> repetitively 


Trace— ^Everything 


trace 


Trace->Until () 


trace before STATE break_on_trigger 


Trace->Until Stop 


trace on_halt 


Trace-^Stop 


stop_trace 


Settings— ^Source/Symbol Modes— ^Absolute 
Settings— ^Source/Symbol Modes— ^Symbols 
Settings— ^Source/Symbol Modes— ^Source 
Mixed 

Settings— ^Source/Symbol Modes— ^Source 
Only 

Settings— ^Display Modes 
Settings— >Pod Command Keyboard 
Settings— ^Simulated IO Keyboard 
Settings— ^Command Line 


set source off symbols off 
set source off symbols on 
set source on inverse_video on symbols on 

set source only inverse_video off symbols on 

set 

display pod_command; pod_command keyboard 
display simulated_io; modify keyboard_to_simio 
N/A (toggles the command line) 
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How Popup Menus Map to the Command Line 

The following tables show the items available in the popup menus and the 
command line commands to which they map. 



Mnemonic Memory Display Popup Command Line 



Set/Clear Breakpoint 


modify software_breakpoints set/clear -EXPR-- 


Edit Source 


! vi +<line> <file> ! no_prompt_before_exit 


Run Until 


run until -EXPR-- 


Trace After 


trace after STATE 


Trace Before 


trace before STATE 


Trace About 


trace about STATE 


Trace Until 


trace before STATE break_on_trigger 




Breakpoints Display Popup 


Command Line 


Set/Inactivate Breakpoint 


modify software_breakpoints set/deactivate — EXPR— 


Clear (delete) Breakpoint 


modify software_breakpoints clear --EXPR-- 


Enable/Disable Software Breakpoints 


modify software_breakpoints enable/disable 


Set All Breakpoints 


modify software_breakpoints set 


Clear (delete) All Breakpoints 


modify software_breakpoints clear 




Symbols Display Popup 


Command Line 


Display Local Symbols 


display local_symbols_in —SYMB— 


Display Parent Symbols 


display local_symbols_in —SYMB—, display 




global_symbols 


Cut Full Symbol Name 


N/A 


Edit File Defining Symbol 


! vi +<line> <file> ! no_prompt_before_exit 
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Status Line Popup 


Command Line 


Remove Temporary Message 


N/A 


Display Error Log 


display error_log 


Display Event Log 


display event_log 


Command Line On/Off 


(toggles command line) 




Command Line Popup 


Command Line 


Position Cursor, Replace Mode 


<INSERT CHAR> key (when in insert mode) 


Position Cursor, Insert Mode 


<INSERT CHAR> key 


Execute Command 


<RETURN> key 


Clear to End of Line 


<CTRL>e 


Clear Entire Line 


<CTRL>u 


Command Line Off 


(toggles command line) 
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Syntax Conventions 

Conventions used in the command syntax diagrams are defined below. 

Oval-shaped Symbols 

Oval-shaped symbols show options available on the softkeys and other commands 
that are available, but do not appear on softkeys (such as log_commands and wait). 
These appear in the syntax diagrams as: 



Rectangular-shaped Symbols 

Rectangular-shaped symbols contain prompts or references to other syntax 
diagrams. Prompts are enclosed with angle brackets (< and >). References to other 
diagrams are shown in all capital letters. Also, references to expressions are shown 
in all capital letters, for example — EXPR— and -SYMB— (see those syntax 
diagrams). These appear in the following syntax diagrams as: 



Circles indicate operators and delimiters used in expressions and on the command 
line as you enter commands. These appear in the syntax diagrams as: 



The -NORMAL- Key 

The softkey labeled -NORMAL- allows you exit the -SYMB- definition, and 
access softkeys that are not displayed when defining expressions. You can press 
this key after you have defined an expression to view other available options. 




<REGISTERS> 



EXPR 



Circles 
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Commands 



Emulator/analyzer interface commands are summarized in the table below and 
described in the following pages. 



!UNIX_COMMAND 

bbaunload 

break 

-i 

cd (change directory) 
cmb_execute 
<command file> 
copy data 4 
copy display 
copy error_log 
copy event_log 
copy global_symbols 
copy help 

copy local_symbols_in 

copy memory 4 

copy pod_command 

copy registers 1 

copy software_breakpoints 

copy status 

copy trace 

cws(change working symbol) 3 
display data 4 
display error_log 



display event_log 
display global_symbols 
display local_symbols_in 
display memory 4 
display pod_command 
display registers 1 
display simulated_io 
display software_breakpoints 
display status 
display trace 
end 

forward 
help 3 

load <absolute_file> 
load configuration 
load emul_mem 
load trace 
load trace_spec 
load user_memory 
log_commands 
modify configuration 
modify keyboard_to_simio 



modify memory 

modify register 1 

modify softwarejjreakpoints 1 

name_of_module 3 

performance_measurement_end 

performance_measurement_init 

performance_measurement_run 

pod_command 

pwd (print working directory) 

pws (print working symbol) 

reset 

run 

set 

specify 
step 

stop_trace 
store memory 
store trace 
store trace_spec 
trace 
wait 3 



1 This option is not available in real-time mode. 

2 This is only available when simulated I/O is defined. 
These commands are not displayed on softkeys. 

4 This option is not available in real-time mode if addresses are in user memory. 
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break 



break 



break 



<RETURN> 



This command causes the emulator to leave user program execution and begin 
executing in the monitor. 

The behavior of break depends on the state of the emulator: 

running Break diverts the processor from execution of your 

program to the emulation monitor. 

reset Break releases the processor from reset, and diverts 

execution to the monitor. 

running in monitor The break command does not perform any operation while 
the emulator is executing in the monitor. 



See Also 



The reset, run, and step commands. 
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bbaunld 

This command is available when the HP Branch Validator product is installed. 
This basis branch analyzer (BBA) product is used to analyze the testing of your 
programs, create more complete test suites, and quantify your level of testing. 

The HP Branch Validator records branches executed in a program and generates 
reports that provide information about program execution during testing. It uses a 
special C preprocessor to add statements that write to a data array when program 
branches are taken. After running the program in the emulator (using test input), 
you can use the bbaunload command to store the BBA information to a file. Then, 
you can generate reports based on the stored information. 

See Also Refer to the HP Branch Validator (BBA) User's Guide for complete details on the 

bbaunload command syntax. 
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cmb execute 



cmb execute 



cmb execute 



<RETURN> 



The cmb_execute command causes the emulator to emit an EXECUTE pulse on its 
rear panel Coordinated Measurement Bus (CMB) connector. All emulators 
connected to the CMB (including the one sending the CMB EXECUTE pulse) and 
configured to respond to this signal will take part in the measurement. 



See Also The specify run and specify trace commands. 
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Use this command with various parameters to save or print emulation and analysis 
information. 

The copy command copies selected information to your system printer or listing 
file, or directs it to an UNIX process. 
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display 
errorjog 
eventjog 
<FILE> 



global_symbols 
help 

<HELP_FILE> 
UNIXCMD 



local_symbols_in 

memory 
noappend 
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copy 

Depending on the information you choose to copy, default values may be options 
selected for the previous execution of the display command. For example, if you 
display memory locations lOh through 20h, then issue a copy memory to myfile 
command, myfile will list only memory locations lOh through 20h. 

The parameters are as follows: 

This allows you to copy a list of memory contents formatted in various data types 
(see display data). 

This allows you to copy the display to a selected destination. 

This allows you to copy the most recent errors that occurred. 

This allows you to copy the most recent events that occurred. 

This prompts you for the name of a file where you want the specified information 
to be copied. If you want to specify a file name that begins with a number, you 
must precede the file name with a backslash. For example: copy display to \12.10 
<RETURN> 

This lets you copy a list of global symbols to the selected destination. 

This allows you to copy the contents of the emulation help files to the selected 
destination. 

This represents the name of the help file to be copied. Available help file names are 
displayed on the softkey labels. 

This represents an UNIX filter or pipe where you want to route the output of the 
copy command. UNIX commands must be preceded by an exclamation point (!). 
An exclamation point following the UNIX command continues command line 
execution after the UNIX command executes. Emulation is not affected when 
using an UNIX command that is a shell intrinsic. 

This lets you copy all the children of a given symbol to the selected destination. 
See the — SYMB-- syntax page and the Symbolic Retrieval Utilities User's Guide 
for information on symbol hierarchy. 

This allows you to copy a list of the contents of memory to the selected destination. 

This causes any copied information to overwrite an existing file with the same 
name specified by <FILE>. If this option is not selected, the default operation is to 
append the copied information to the end of an existing file with the same name 
that you specify. 
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copy 

noheader This copies the information into a file without headings. 

pod_COmmand This allows you to copy the most recent commands sent to the HP 64700 Series 

emulator/analyzer. 

printer This option specifies your system printer as the destination device for the copy 

command. Before you can specify the printer as the destination device, you must 
define PRINTER as a shell variable. For example, you could enter the text shown 
below after the "$" symbol: 

S PRINTER=lp 

S export PRINTER 

If you don't want the print message to overwrite the command line, execute: 
$ set PRINTER = "lp -s" 



registers This allows you to copy a list of the contents of the emulation processor registers to 
the selected destination. 

software This option lets you copy a list of the current software breakpoints to a selected 

_breakpointS destination. 

Status This allows you to copy emulation and analysis status information, 

to This allows you to specify a destination for the copied information, 

trace This lets you copy the current trace listing to the selected destination. 



An exclamation point specifies the delimiter for UNIX commands. An exclamation 
point must precede all UNIX commands. A trailing exclamation point should be 
used if you want to return to the command line and specify noheader. Otherwise, 
the trailing exclamation point is optional. If an exclamation point is part of the 
UNIX command, a backslash (\) must precede the exclamation point. 



Examples See the following pages on various copy syntax diagrams. 

See Also See the following pages on various copy syntax diagrams. 
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copy local_symbols_in 



copy local_symbols_in 



C 



copy J— »^Joca I _ s m 



bols Jn)- 



To output of 



LOCALSYMBOLSJN 



COPY diagram 



This command lets you copy local symbols contained in a source file and relative 
segments (program, data, or common) to the selected destination. 

Local symbols are symbols that are children of the particular file or symbol defined 
by --SYMB--, that is, they are defined in that file or scope. 

For additional information on symbols, refer to the --SYMB-- syntax pages and the 
Symbolic Retrieval Utilities User's Guide. 

--SYMB-- is the current working symbol. 

The parameters are as follows: 

— SYMB— This option represents the symbol whose children are to be listed. See the 

— SYMB-- syntax diagram and the Symbolic Retrieval Utilities User's Guide for 
information on symbol hierarchy. 



Examples 

copy local_symbols_in mod_name to printer <RETURN> 

copy local_symbols_in mod_name : to linenumfile <RETURN> 

See Also The display local_symbols_in command. 
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copy memory 



copy memory 

C copy f me 



mory 





— EXPR— 




rr ' 





thru 



-EXPR- 



o 



To output of 



v ie v ::^ v 



on COPY diagram 



This command copies the contents of a memory location or series of locations to 
the specified output. 

The memory contents are copied in the same format as specified in the last display 
memory command. 

Contents of memory can be displayed if program runs are not restricted to 
real-time. Memory contents are listed as an asterisk (*) under the following 
conditions: 

1 The address refers to guarded memory. 

2 Runs are restricted to real-time, the emulator is running a user program, and 
the address is located in user memory. 

Values in emulation memory can always be displayed. 

Initial values are the same as those specified by the command display memory 0 
blocked bytes offsetjby 0. 

Defaults are to values specified in the previous display memory command. 
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copy memory 

The parameters are as follows: 

--EXPR-- An expression is a combination of numeric values, symbols, operators, and 

parentheses, specifying a memory address or offset value. See the EXPR syntax 
diagram. 

FCODE The function code used to define the address space being referenced. See the syntax 

diagram for FCODE to see a list of the function codes available and for an 
explanation of those codes. 

, A comma used immediately after memory in the command line appends the 

current copy memory command to the preceding display memory command. The 
data specified in both commands is copied to the destination specified in the current 
command. Data is formatted as specified in the current command. The comma is 
also used as a delimiter between values when specifying multiple memory 
addresses. 



Examples 

copy memory start to printer <RETURN> 

copy memory 0 thru lOOh , start thru +5 , 500H , 
target2 to memlist <RETURN> 

copy memory 2000h thru 204fh to memlist <RETURN> 
See Also The display memory, modify memory, and store memory commands. 
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copy registers 

copy f~*\ registers 





<CLASS> 









To output of REGISTERS 
COPY diagram 



<REGISTER> - 



<CLASS> 
<REGISTER> 



This command copies the contents of the processor registers to a file or printer. 

The copy register process does not occur in real-time. The emulation system must 
be configured for nonreal-time operation to list the registers while the processor is 
running. 

With no options specified, the basic register class is copied. 
The parameters are as follows: 
Specifies a particular class of the emulator registers. 
Specifies an individual register. 



Examples 



copy registers basic to printer <RETURN> 
copy registers to reglist <RETURN> 



See Also 



The display registers and modify registers commands. 
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copy trace 



copy trace 



Q copy 

r 



trace 



from line number) — ► < LI N E #> — H thru line number ) — - < LI N E #> 



To output of TRACE 



on COPY diagram 



This command copies the contents of the trace buffer to a file or to the printer. 

Trace information is copied in the same format as specified in the last display trace 
command. 

Initial values are the same as specified by the last display trace command. 
The parameters are as follows: 
f rom_line_number This specifies the trace list line number from which copying will begin. 



<LINE#> 

thru_line_number Specifies the last line number of the trace list to include in the copied range 



Use this with from_line_number and thru_line_number to specify the starting 
and ending trace list lines to be copied. 



Examples 



copy trace to tlist <RETURN> 

copy trace from_llne_number 0 thru_line_number 5 

to longtrac <RETURN> 



See Also 



The display trace and store trace commands. 
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display 



display 

f display 



DATA 





MEMORY 











TRACE 











REGISTERS 

















GLOBAL_SYMBOLS 





LOCAL_SYMBOLSJN 





SIMULATEDJO 









SOFTWARE_BREAKPOINTS 



errorjog 



eventjog 



pacLcommand 



status 



<RETURN> 



This command displays selected information on your screen. 

You can use the <Up arrow>, <Down arrow>, <PREV>, and <NEXT> keys to 
view the displayed information. For software_breakpoints, data, memory, and trace 
displays you can use the <CTRL>g and <CTRL>f keys to scroll left and right if the 
information goes past the edge of the screen. 

Depending on the information you select, defaults may be the options selected for 
the previous execution of the display command. 

The parameters are as follows: 

data This allows you to display a list of memory contents formatted in various data types 

(see the display data pages for details). 

erroMog This option displays the recorded list of error messages that occurred during the 

emulation session. 
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display 

This option displays the recorded list of events. 

This option lets you display a list of all global symbols in memory. 

This option lets you display all the children of a given symbol. See the --SYMB-- 

syntax page and the Symbolic Retrieval Utilities User's Guide for details on symbol 
hierarchy. 

This option allows you to display the contents of memory. 

This option lets you display the output of previously executed emulator pod 
commands. 

This allows you to display the contents of emulation processor registers. 

This lets you display data written to the simulated I/O display buffer after you have 
enabled polling for simulated I/O in the emulation configuration. 

This option lets you display the current list of software breakpoints. 

This displays the emulator and trace status. 
This displays the current trace list. 



Examples 



display event_log <RETURN> 

display local_symbols_in mod_name <RETURN> 



See Also 



The copy command description and the following pages which describe the various 
display commands. 
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display data 




The display data command can display the values of simple data types in your 
program. Using this command can save you time; otherwise, you would need to 
search through memory displays for the location and value of a particular variable. 

The address, identifier, and data value of each symbol may be displayed. You must 
issue the command set symbols on to see the symbol names displayed. 

In the first display data command after you begin an emulation session, you must 
supply at least one expression specifying the data item(s) to display. 

Thereafter, the display data command defaults to the expressions specified in the 
last display data command, unless new expressions are supplied or appended (with 
a leading comma). 
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-EXPR- 



thru --EXPR- 



<TYPE> 

byte 
word 
long 

int8 

int16 

int32 

u_int8 

u_int1 6 

u_int32 

char 
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display data 

Symbols are normally set off until you give the command set symbols on. 
Otherwise, only the address, data type, and value of the data item will be displayed. 

The parameters are as follows: 

A leading comma allows you to append additional expressions to the previous 
display data command. 

Commas between expression/data type specifications allow you to specify multiple 
variables and types for display with the current command. 

Prompts you for an expression specifying the data item to display. The expression 
can include various math operators and program symbols. See the -EXPR- and 
-SYMB-- syntax pages for more information. 

Allows you to specify a range of addresses for which you want data display. 
Typically, you use this to display the contents of an array. You can display both 
single-dimensioned and multi-dimensioned arrays. Arrays are displayed in the 
order specified by the language definition, typically row major order for most 
Algol-like languages. 

Specifies the format in which to display the information. (Data type information is 
not available from the symbol database, so you must specify.) 

Hex display of one 8 bit location. 

Hex display of one 16 bit location. 

Hex display of one 32 bit location. 

Note that byte ordering in word and long displays is determined by the conventions 
of the processor in use. 

Display of one 8 bit location as a signed integer using two's complement notation. 
Display of two bytes as a signed integer using two's complement notation. 
Display of four bytes as a signed integer using two's complement notation. 
Display of one byte as an unsigned positive integer. 
Display of two bytes as an unsigned positive integer. 
Display of four bytes as an unsigned positive integer. 

Displays one byte as an ASCII character in the range 0 through 127. Control 
characters and values in the range 128 through 255 are displayed as a period (.). 
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display data 

Examples 

display data Msg_A thru +17 char, Stack long <RETURN> 
set symbols on <RETURN> 
set width label 30 < RE TURN > 

display data , Msg_B thru +17 char, Msg_Dest thru +17 

char < RET URN > 

See Also The copy data and set commands. 



398 



Chapter 12: Emulator/Analyzer Interface Commands 

display global_symbols 



display global_symbols 



c 



display 



globaLsymbols 




To <RETURN> 



on 



DISPLAY 



diagram 



This command displays the global symbols defined for the current absolute file. 

Global symbols are symbols declared as global in the source file. They include 
procedure names, variables, constants, and file names. When the display 
globaLsymbols command is used, the listing will include the symbol name and its 
logical address. 



See Also 



The copy globaLsymbols command. 
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display local_symbols_in 



display local_symbols_in 



display ^)— M^locaLsymbols_in^)- 



To <RETURN> 



-SYMB- 



DISPLAY diagram 



Displays the local symbols in a specified source file and their relative segment 
(program, data, or common). 

Local symbols of --SYMB-- are the ones which are children of the file and/or scope 
specified by --SYMB--. That is, they are defined in that file or scope. 

See the --SYMB-- syntax pages and the Symbolic Retrieval Utilities User's Guide 
for further explanation of symbols. 

Displaying the local symbols sets the current working symbol to the one specified. 

The parameters are as follows: 

— SYMB— This option represents the symbol whose children are to be listed. See the 

— SYMB-- syntax diagram and the Symbolic Retrieval Utilities User's Guide for 
more information on symbol hierarchy and representation. 



Examples 

display local_symbols_in mod_name <RETURN> 
display local_symbols_in mod_name : main <RETURN> 

See Also The copy local_symbols_in command. 
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display memory 



display memory 




This command displays the contents of the specified memory location or series of 
locations. 
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display memory 

The memory contents can be displayed in mnemonic, hexadecimal, or real number 
format. In addition, the memory addresses can be listed offset by a value, which 
allows the information to be easily compared to the program listing. 

When displaying memory mnemonic and stepping, the next instruction that will 
step is highlighted. The memory mnemonic display autopages to the new address if 
the next PC goes outside the currently displayed address range. This feature works 
even if stepping is performed in a different emulation window than the one 
displaying memory mnemonic. 

Pending software breakpoints are shown in the memory mnemonic display by an 
asterisk (*) in the leftmost column of the assembly instruction or source line that 
has a pending breakpoint. 

A label column (symbols) may be displayed for all memory displays except 
blocked mode. Memory mnemonic may be displayed with source and assembly 
code intermixed, or with source code only. Symbols also can be displayed in the 
memory mnemonic string. (See the set command.) 

Initial values are the same as specified by the command: 

display memory 0 blocked bytes offset_by 0 

Defaults are values specified in a previous display memory command. 
The symbols and source defaults are: 
set source off symbols off 

The parameters are as follows: 
Formats the memory listing in a single column. 

Displays the memory at the address pointed to by the current program counter value. 

Formats the memory listing in multiple columns. 

Displays the absolute or blocked memory listing as byte values. 

An expression is a combination of numeric values, symbols, operators, and 
parentheses, specifying a memory address or memory offset value. See the EXPR 
syntax diagram. 



absolute 

at_pc 

blocked 

bytes 

-EXPR- 
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previous_display 
real 

repetitively 



short 
thru 



words 
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display memory 

The function code used to define the address space being referenced. See the syntax 
diagram for FCODE to see a list of the function codes available and for an 
explanation of those codes. 

Displays memory in a 64-bit real number format or 32-bit long words when 
preceded by blocked or absolute. 

This causes the memory listing to be formatted in assembly language instruction 
mnemonics with associated operands. When specifying mnemonic format, you 
should include a starting address that corresponds to the first byte of an operand to 
ensure that the listed mnemonics are correct. If set source only is on, you will see 
only the high level language statements and corresponding line numbers. 

This option lets you specify an offset that is subtracted from each of the absolute 
addresses before the addresses and corresponding memory contents are listed. You 
might select the offset value so that each module appears to start at address 0000H. 
The memory contents listing will then appear similar to the assembler or compiler 
listing. 

This option is also useful for displaying symbols and source lines in dynamically 
relocated programs. 

Returns to display associated with the previous mnemonic memory display 
command. 

Formats memory values in the listing as real numbers. (NaN in the display list 
means "Not a Number.") 

Updates the memory listing display continuously. You should only use this to 
monitor memory while running user code, since it is very CPU intensive. To allow 
updates to the current memory display whenever memory is modified, a file is 
loaded, software breakpoint is set, etc., use the set update command. 

Formats the memory list as 32-bit real numbers. 

This option lets you specify a range of memory locations to be displayed. Use the 
<Up arrow>, <Down arrow>, <NEXT>, and <PREV> keys to view additional 
memory locations. 

Displays the absolute or blocked memory listing as 16-bit word values. 

A comma after memory in the command line appends the current display memory 
command to the preceding display memory command. The data specified in both 
commands is displayed. The data will be formatted as specified in the current 
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command. The comma is also a delimiter between values when specifying multiple 
addresses. 



Examples You can display memory in real number and mnemonic formats: 

display memory 2000h thru 2 02fh , 2100h real long 
<RETURN> 

display memory 4 0 Oh mnemonic <RETURN> 

set symbols on <RETURN> 

set source on <RETURN> 

display memory main mnemonic <RETURN> 

See Also The copy memory, modify memory, set, and store memory commands. 



404 



Chapter 12: Emulator/Analyzer Interface Commands 

display registers 



display registers 

display ^~*{^ registers 



To <RETURN> on 



<CLASS> 







<REGISTER> 





DISPLAY diagram 



This command displays the current contents of the emulation processor registers. 

If a step command just executed, the mnemonic representation of the last 
instruction is also displayed, if the current display is the register display. This 
process does not occur in real-time. The emulation system must be configured for 
nonreal-time operation to display registers while the processor is running. Symbols 
also may be displayed in the register step mnemonic string (see set symbols). 

With no options specified, the basic register class is displayed as the default. This 
includes the local and global registers. 

The parameters are as follows: 

<CLASS> This allows you to display a particular class of emulation processor registers. 

<REGISTER> This displays an individual register. 



Examples 

display registers <RETURN> 

display registers BASIC D2 <RETURN> 

See Also The copy registers, modify registers, set, and step commands. 
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display simulated_io 



c 



display 



c 



simulated io 



To <RETURN> on 



DISPLAY 



diagram 



This command displays information written to the simulated I/O display buffer. 

After you have enabled polling for simulated I/O during the emulation 
configuration process, six simulated I/O addresses can be defined. You then define 
files used for standard input, standard output, and standard error. 

For details about setting up simulated I/O, refer to the Simulated I/O User's Guide. 



Examples 



display simulated_io <RETURN> 



See Also 



The modify configuration and modify keyboard_to_simio commands. 
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display software_breakpoints 



Q disploy j — »^softwore_breokpoints^- 




offset 



-EXPR- 



To 



<RETURN> 



DISPLAY diagram 



-EXPR- 



offset_by 



This command displays the currently defined software breakpoints and their status. 

If the emulation session is continued from a previous session, the listing will 
include any previously defined breakpoints. The column marked "status" shows 
whether the breakpoint is pending, inactivated, or unknown. 

A pending breakpoint causes the processor to enter the emulation monitor upon 
execution of that breakpoint. Executed breakpoints are listed as inactivated. 
Entries that show an inactive status can be reactivated by executing the modify 
softwarejbreakpoints set command. 

A label column also may be displayed for addresses that correspond to a symbol. 
See the set command for details. 

The parameters are as follows: 

An expression is a combination of numeric values, symbols, operators, and 
parentheses, specifying an offset value for the breakpoint address. See the 
--EXPR-- syntax diagram. 

This option allows you to offset the listed software breakpoint address value from 
the actual address of the breakpoint. By subtracting the offset value from the 
breakpoint address, the system can cause the listed address to match that given in 
the assembler or compiler listing. 



Examples 



display software_breakpoints <RETURN> 

display software_breakpoints offset_by 1000H <RETURN> 



See Also 



The copy softwarejbreakpoints, modify softwarejbreakpoints, and set 

commands. 
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display trace 



display trace 



absolute 



pnic^)— 

> 



o u n t J- 



depth 





<DEPTH#> 









disassemble_f rom_line_number < LINE #> 



stat 



us j- 



-°\ blnar 



hex 



mnemonic 



absolute 
relative 



*J — s- binary J - 



externaLlabel 



binary 



hex 



offset.by )-*■ — EXPR— 



To I <RETURN> 



then 



DISPLAY diagram 



* available when external labels are in use 



This command displays the contents of the trace buffer. 

Captured information can be presented as absolute hexadecimal values or in 
mnemonic form. The processor status values captured by the analyzer can be listed 
mnemonically or in hexadecimal or binary form. 
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Addresses captured by the analyzer are physical addresses. 

The offsetjby option subtracts the specified offset from the addresses of the 
executed instructions before listing the trace. With an appropriate entry for offset, 
each instruction in the listed trace will appear as it does in the assembled or 
compiled program listing. 

The count parameter lists the time associated with a trace event either relative to 
the previous event in the trace list or as an absolute count measured from the trigger 
event. 

The source parameter allows display of source program lines in the trace listing, 
enabling you to quickly correlate the trace list with your source program. 

Initial values are the same as specified by the command: 

display trace mnemonic count relative offset_by 0 

<RETURN> 



absolute 
count 

absolute 

relative 

depth 
<DEPTH#> 



disassemble 

_from_line 

_number 

-EXPR- 



The parameters are as follows: 

Lists trace information in hexadecimal format, rather than mnemonic opcodes. 



This lists the time count for each event of the trace as the total time measured from 
the trigger event. 

This lists the time count for each event of the trace as the time measured relative to 
the previous event. 



This defines the number of states to be uploaded by the interface. 

Note that after you have changed the trace depth, execute the command wait 
measurement_complete before displaying the trace. Otherwise the new trace states 
will not be available. 

Displays the trace at a certain line number and disassembles instruction opcodes. 



An expression is a combination of numeric values, symbols, operators, and 
parentheses, specifying an offset value to be subtracted from the addresses traced 
by the emulation analyzer. See the EXPR syntax diagram. 
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external 

binary 

<external 
_label> 

hex 

off 

then 

<LINE#> 



mnemonic 
offset_by 



Displays the external analyzer trace list in binary format. 
This option displays a defined external analyzer label. 

Displays the external analyzer trace list in hexadecimal format. 
Use this option to turn off the external trace list display. 

This allows you to display multiple external analysis labels. This option appears 
when more than one external analyzer label is in use. 

This prompts you for the trace list line number to be centered in the display. Also, 
you can use <LINE#> with disassemble_from_line_number. <LINE#> prompts 
you for the line number from which the inverse assembler attempts to disassemble 
data in the trace list. 

Lists trace information with opcodes in mnemonic format. 

This option allows you to offset the listed address value from the address of the 
instruction. By subtracting the offset value from the physical address of the 
instruction, the system makes the listed address match that given in the assembler 
or compiler listing. 

This option is also useful for displaying symbols and source lines in dynamically 
relocated programs. 

Note that when using the set source only command, the analyzer may operate more 
slowly than when using the set source on command. This is an operating 
characteristic of the analyzer: 

When you use the command set source on, and are executing only assembly 
language code (not high-level language code), no source lines are displayed. 
The trace list will then fill immediately with the captured assembly language 
instructions. 

When using set source only, no inverse assembled code is displayed. 
Therefore, the emulation software will try to fill the display with high-level 
source code. This requires the emulation software to search for any captured 
analysis data generated by a high-level language statement. 

In conclusion, you should not set the trace list to set source only when tracing 
assembly code. This will result in optimum analyzer performance. 
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status 

binary Lists absolute status information in binary form. 

hex Lists absolute status information in hexadecimal form. 

mnemonic Lists absolute status information in mnemonic form. 

Examples 

display trace count absolute <RETURN> 
display trace absolute status binary <RETURN> 
display trace mnemonic <RETURN> 

See Also The copy trace, store trace, and set commands. 
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end 



( end \ 



=RETURN> 



! :: :: k ^ : 



— ~C release_system ~~) 



locked 



release_system 



This command terminates the current emulation session. 

You can end the emulation session and keep the emulator in a locked state. The 
current emulation configuration is stored, so that you can continue the emulation 
session on reentry to the emulator. You also can release the emulation system when 
ending the session so that others may use the emulator. 

Note that pressing <CTRL>d performs the same operation as pressing end 
<RETURN>. Pressing <CTRL>\ or <CTRL>I performs the same as end 
release_system <RETURN>. 

When the emulation session ends, control returns to the UNIX shell without 
releasing the emulator. 

The parameters are as follows: 

This option allows you to stop all active instances of an emulator/analyzer interface 
session in one or more windows and/or terminals. This option is not available 
when operating the emulator in the measurement system. 

This option stops all instances of the emulator/analyzer interface in one or more 
windows or terminals. The emulation system is released for other users. If you do 
not release the emulation system when ending, others cannot access it. 



Examples 



end <RETURN> 



end release_system <RETURN> 



See Also 



The "Exiting the Emulator/ Analyzer Interface" section in the "Starting and Exiting 
HP 64700 Interfaces" chapter. 
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--EXPR-- 




An expression is a combination of numeric values, symbols, operators, and 
parentheses used to specify address, data, status, executed address, or any other 
value used in the emulation commands. 

The function of an expression (-EXPR-) is to let you define the address, data, 
status, or executed address expression that fits your needs. You can combine 
multiple values to define the expression. 

Certain emulation commands will allow the option of <+EXPR> after pressing a 
thru softkey. This allows you to enter a range without retyping the original base 
address or symbol. For example, you could specify the address range 

disp_buf thru disp_buf + 2 5 
as 

disp_buf thru +25 

The parameters are as follows: 

DON'T CARE You can include "don't care numbers" in expressions. These are indicated by a 

NUMBER number containing an "x." These numbers may be defined as binary, octal, decimal, 

or hexadecimal. For example: lfxxh, 17x7o, and 01 lxxxlOb are valid. 

Note that "Don't care numbers" are not valid for all commands. 

—NORMAL— This appears as a softkey label to enable you to return to the — EXPR-- key. The 

—NORMAL— label can be accessed whenever defining an expression, but is only 
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<NUMBER> 



<OP> 



-SYMB- 



end 



start 



<UNARY> 



( ) 



valid when "C" appears on the status line, which indicates a valid expression has 
been defined. 

This can be an integer in any base (binary, octal, decimal, or hexadecimal), or can 
be a string of characters enclosed with quotation marks. 

This represents an algebraic or logical operand and may be any of the following (in 
order of precedence): 



mod 


modulo 


* 


multiplication 


/ 


division 


& 


logical AND 


+ 


addition 




subtraction 


I 


logical OR 



This allows you to define symbolic information for an address, range of addresses, 
or a file. See the --SYMB-- syntax pages and the Symbolic Retrieval Utilities 
User's Guide for more information on symbols. 

This displays the last location where the symbol information may be located. For 
example, if a particular symbol is associated with a range of addresses, end will 
represent the last address in that range. 

This displays first memory location where the symbol you specify may be located. 
For example, if a particular symbol is associated with a range of addresses, start 
will represent the first address in that range. 

This defines either the algebraic negation (minus) sign (-) or the logical negation 
(NOT) sign (-). 

Parentheses may be used in expressions to enclose numbers. For every opening 
parenthesis, a closing parenthesis must exist. 

Note that when "C" appears on the right side of the status line, a valid expression 
exists. The —NORMAL— key can be accessed at any time, but is only valid when 
"C" is on the command line. 

Note that when a thru softkey has been entered, a <+ EXPR> prompt appears. 
This saves you from tedious repeated entry of long symbols and expressions. For 
example: 
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disp_buf thru +25 
is the same as 

disp_buf thru disp_buf + 2 5 

Examples 

05fxh 
Offffh 

disp_buf + 5 

symb_tbl + (offset / 2) 

start 

mod_name : line 15 end 
See Also The SYMB syntax description. 
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FCODE 




The function code is used to define the address space being referenced. Select the 
appropriate function code from those listed below. 

d Data space. 

none Causes the emulator to ignore the function code bits. 

p Program space. 

S Supervisor space. 

sd Supervisor data space. 

sp Supervisor program space. 

U User space. 

ud User data space. 

up User program space. 



416 



Chapter 12: Emulator/Analyzer Interface Commands 
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Examples To copy a portion of user data memory to a file: 

copy memory fcode ud 1000H thru IfffH to mymem <RETURN> 

To modify a location in program memory: 

modify memory fcode p 5000h long to 12345678h <RETURN> 
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forward 



Q forward JK; — -(^ debug J — j— <COMMAND> - <RETURN> 



perf 



bms 



<UINAME> 



This command lets you forward commands to other HP 64700 interfaces that use 
the "emul700dmn" daemon process to coordinate actions between the interfaces. 

bms Sends messages to the Broadcast Message Server or BMS. 

<COMMAND> An ASCII string, enclosed in quotes, that is the command to be forwarded to the 

named interface. 

debug Forwards command to the high-level debugger interface. 

emul Forwards command to the emulator/analyzer interface. 

pert Forwards commands to the software performance analyzer interface. 

<UINAME> Forwards commands to a user interface name other than those available on the 

softkeys. 



Examples To send the "Program Run" command to the debugger: 

forward debug "Program Run" <RETURN> 

To send the "profile" command to the software performance analyzer: 
forward debug "profile" <RETURN> 

See Also The User's Guide for the interface to which you are forwarding commands. 
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help 





<HELP_FILE> 




<RETURN> 







Displays information about system and emulation features during an emulation 
session. 

Typing help or ? displays softkey labels that list the options on which you may 
receive help. When you select an option, the system will list the information to the 
screen. 

The help command is not displayed on the softkeys. You must enter it into the 
keyboard. You may use a question mark in place of help to access the help 
information. 

The parameters are as follows: 

<HELP_FILE> This represents one of the available options on the softkey labels. You can either 

press a softkey representing the help file, or type in the help file name. If you are 
typing in the help file name, make sure you use the complete syntax. Not all of the 
softkey labels reflect the complete file name. 



Examples 

help syst&m_commands <RETURN> 

? run <RETURN> 

This is a summary of the commands that appear on the softkey labels when you 
type help or press ?: 

system_commands 

run 

trace 

step 

break 

display 

modify 

load 
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store 
copy 
reset 

stop_trace 
end 

software_breakpoints 
registers 

expressions (— EXPR— ) 
symbols (-SYMB-) 
specify 
cmb 

cmb_execute 

map 

set 

wait 

pod_command 
bbaunload 

coverage 

performance_measurement_initialize 

performance_measurement_run 

performance_measurement_end 
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load 



load 

c 



c:jt 





<FILE> 




<RETURN> 


^ 


\ 


( 



' emuLmem 



user_mem 



V 



configuraiian 



symbols 



s . 



'nDsymbols^}^ 



<FILE = 



<FILE> 
<FILE> 



noupdale 



This command transfers absolute files from the host computer into emulation or 
target system RAM. With other parameters, the load command can load emulator 
configuration files, trace records, trace specifications, or symbol files. 

The absolute file contains information about where the file is stored. The memory 
map specifies that the locations of the file are in user (target system) memory or 
emulation memory. This command also allows you to access and display 
previously stored trace data, load a previously created configuration file, and load 
absolute files with symbols. 

Note that any file specified by <FILE> cannot be named "configuration", 
"emul_mem", "user_mem", "symbols", "trace", or "trace_spec" because these are 
reserved words, and are not recognized by the emulator/analyzer interface as 
ordinary file names. 



The absolute file is loaded into emulation memory by default. 
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The parameters are as follows: 



configuration 

emul_mem 
<FILE> 

noabort 

nosymbols 
noupdate 



symbols 
trace 

trace_spec 



user mem 



This option specifies that a previously created emulation configuration file will be 
loaded into the emulator. You can follow this option with a file name. Otherwise 
the previously loaded configuration will be reloaded. 

Loads only those portions of the absolute file that reside in memory ranges mapped 
as emulation memory. 

This represents the absolute file to be loaded into either target system memory, 
emulation memory (.X files are assumed), or the trace memory (.TR files are 
assumed). 

This option allows you to load a file even if part of the file is located at memory 
mapped as "guarded" or "target ROM" (trom). 

This option causes the file specified to be loaded without symbols. 

This option suppresses rebuilding of the symbol data base when you load an 
absolute file. If you load an absolute file, end emulation, then modify the file (and 
relink it), the symbol database will not be updated upon reentering emulation and 
reloading the file. The default is to rebuild the database. 

This option causes the file specified to be loaded with symbols. 

This option allows you to load a previously generated trace file. 

This option allows you to load a previously generated trace specification. 

Note that the current trace specification will be modified, but a new trace will not 
be started. To start a trace with the newly loaded trace specification, enter trace 
again or specify trace again (not trace). If you specify trace, a new trace will 
begin with the default trace specification, not the one you loaded. 

Loads only those portions of the absolute file that reside in memory ranges mapped 
as target memory. 



Examples 



load sortl <RETURN> 



load configuration config3 <RETURN> 



See Also 



The display trace command. 
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log_commands 

( jog_ commands ^ to ^ — - 



~of1 J- 



<FILE> 




<RETURN> 






^ — -^nooppGnc l) -/ f' 





<FILE> 
noappend 

off 
to 



This command allows you to record commands that are executed during an 
emulation session. 

Commands executed during an emulation session are stored in a file until this 
feature is turned off. This is a handy method for creating command files. 

To execute the saved commands after the file is closed, type the filename on the 
command line. 

The parameters are as follows: 

This represents the file where you want to store commands that are executed during 
an emulation session. 

If the named file is an existing file, this option causes the new commands to 
overwrite any information present in the file. If this option is not specified, new 
commands are appended to the existing contents of the file. 

This option turns off the capability to log commands. 

This allows you to specify a file for the logging of commands. 



Examples 



log_commands to logfile <RETURN> 
log_commands off < RET URN > 



See Also 



The wait command. 
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modify 



modify 





MEMORY 




<RETURN> 









REGISTER 









CONFIGURATION 



50FTWARE_BREAKP0INTS 



KEYBOARD_TO_SIMIO 



This command allows you to observe or change information specific to the 
emulator. 

The modify command is used to: 

• Modify contents of memory (as integers, strings, or real numbers). 

• Modify the contents of the processor registers. 

• View or edit the current emulation configuration. 

• Modify the software breakpoints table. 

The following pages contain detailed information about the various modify syntax 
diagrams. 
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modify configuration 



modify configuration 

modify J— »-((^ onfiguratio n)- > -To <RETURN> 



on MODIFY 



diagram 



This command allows you to view and edit the current emulation configuration 
items. 

The configuration questions are presented in sequence with either the default 
response, or the previously entered response. You can select the currently 
displayed response by pressing <RETURN>. Otherwise, you can modify the 
response as you desire, then press <RETURN>. 

The default responses defined on powerup are displayed. 



Examples 

modify configuration <RETURN> 



See Also The load configuration command. 
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modify keyboard_to_simio 



C 



modify 




keyboard _to_simio 



To output of 



KEYBOARD TO SIMIO 



on 



MODIFY 



diagram 



This command allows the keyboard to interact with your program through the 
simulated I/O software. 

When the keyboard is activated for simulated I/O, its normal interaction with 
emulation is disabled. The emulation softkeys are blank and the softkey labeled 
"suspend" is displayed on your screen. Pressing suspend <RETURN> will 
deactivate keyboard simulated I/O and return the keyboard to normal emulation 
mode. For details about setting up simulated I/O, refer to the Simulated I/O User's 
Guide. 



See Also 



The display simulated_io command. 
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modify memory 



modify memory 



c 



modify 



memory 



— EXPR— 



Fl 3 )E 



thru 



bytes 



words 



long 



— EXPR — 




;hort 




C long J-^ 



string 



t:: 



= STRING = 



— To 



<RETURN> 



on MODIFY diagram 



This command lets you modify the contents of selected memory locations. 

You can modify the contents of individual memory locations to individual values. 
Or, you can modify a range of memory to a single value or a sequence of values. 

Modify a series of memory locations by specifying the address of the first location 
in the series to be modified, and the values to which the contents of that location 
and successive locations are to be changed. The first value listed will replace the 
contents of the first memory location. The second value replaces the contents of 
the next memory location in the series, and so on, until the list is exhausted. When 
more than one value is listed, the value representations must be separated by 
commas. (See the examples for more information.) 
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A range of memory can be modified such that the content of each location in the 
range is changed to the single specified value, or to a single or repeated sequence. 
This type of memory modification is done by entering the limits of the memory 
range to be modified (— EXPR— thru -EXPR— ) and the value or list of values 
(-EXPR-, ... , -EXPR-) to which the contents of all locations in the range are to 
be changed. 

Note that if the specified address range is not large enough to contain the new data, 
only the specified addresses are modified. 

If the address range contains an odd number of bytes and a word operation is being 
executed, the last word of the address range will be modified. Thus the memory 
modification will stop one byte after the end of the specified address range. 

If an error occurs in writing to memory (to guarded memory or target memory with 
no monitor) the modification is aborted at the address where the error occurred. 

For integer memory modifications, the default is to the current display memory 
mode, if one is in effect. Otherwise the default is to "byte." 

For real memory modifications, the default is to the current display memory mode, 
if one is in effect. Otherwise the default is "word." 

The parameters are as follows: 



bytes Modify memory in byte values. 

-EXPR- An expression is a combination of numeric values, symbols, operators, and 

parentheses, specifying a memory address. See the EXPR syntax diagram. 

FCODE The function code used to define the address space being referenced. See the syntax 

diagram for FCODE to see a list of the function codes available and for an 
explanation of those codes. 

long Modify memory values as 32-bit long word values or 64-bit real values when 

preceded by real. 

real Modify memory as real number values. 

<REAL#> This prompts you to enter a real number as the value. 

Short Modify memory values as 32-bit real numbers. 

words Modify memory values as 16-bit values. 

String Modify memory values to the ASCII character string given by <STRfNG>. 
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<STRING> Quoted ASCII string including special characters as follows: 



null \0 

newline \n 

horizontal tab \t 

backspace \b 

carriage return \r 

form feed \f 

backslash \\ 

single quote V 

bit pattern \ooo (where ooo is an octal number) 



thru This option lets you specify a range of memory locations to be modified. 

to This lets you specify values to which the selected memory locations will be 

changed. 

words Modify memory locations as 32-bit values. 

, A comma is used as a delimiter between values when modifying multiple memory 

addresses. 



Examples 

modify memory datal bytes to 0E3H , 01H , 08H <RETURN> 
modify memory datal thru DATA100 to OFFFFH <RETURN> 
modify memory 0675H real to -1.303 <RETURN> 
modify memory temp real long to 0.5532E-8 <RETURN> 
modify memory buffer string to "Test \n\0" <RETURN> 

See Also The copy memory, display memory, and store memory commands. 
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modify register 



modify ^)~*"(^ register 



<REGISTER> 



<CLASS> 




to 



EXPR 



To <RETURN> 



on MODIEY diagram 



-EXPR- 

<REGISTER> 
to 



This command allows you to modify the contents of the emulation processor 
internal registers. 

The entry you specify for <REGISTER> determines which register is modified. 

Register modification cannot be performed during real-time operation of the 
emulation processor. A break command or condition must occur before you can 
modify the registers. 

The parameters are as follows: 

An expression is a combination of numeric values, symbols, operators, and 
parentheses, specifying a register value. For the floating-point registers, the value 
is interpreted as a decimal real number. See the --EXPR-- description. 

This represents the name of a register. 

Allows you to specify the values to which the selected registers will be changed. 



Examples 



modify register D2 to 41H <RETURN> 



See Also 



The copy registers, display registers, and modify registers commands. 
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modify software_breakpoints 




This command changes the specification of software breakpoints. 

Software breakpoints provide a way to accurately stop the execution of your 
program at one or more instruction locations. When a software breakpoint is set, 
the instruction that is normally at that location is replaced with a TRAP instruction. 
When the software breakpoint is executed, control is passed to the emulator's 
monitor program, and the original instruction is restored in the user program. Thus, 
execution is interrupted before the instruction at the specified address is executed. 

Operation of the program can be resumed after the breakpoint is encountered, by 
specifying either a run or step command. 

If you modify software breakpoints while the memory mnemonic display is active, 
the new breakpoints are indicated by a "*" in the leftmost column of the instruction 
containing the breakpoint. 

The software breakpoint facility may be completely disabled or enabled via the 
"modify software_breakpoints" command. The default is "enabled". 
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clear 

disable 
enable 
--EXPR-- 

permanent 
set 

temporary 



The parameters are as follows: 

This option erases the specified breakpoint address. If no breakpoints are specified 
in the command, all currently specified breakpoints are cleared. 

This option turns off the software breakpoint capability. 

This option allows you to modify the software breakpoint specification. 

An expression is a combination of numeric values, symbols, operators, and 
parentheses, specifying a software breakpoint address. See the EXPR syntax 
diagram. 

Sets a permanent breakpoint. The software breakpoint instruction remains in the 
program until the breakpoint is inactivated or removed. 

This option allows you to activate software breakpoints in your program. If no 
breakpoint addresses are specified in the command, all breakpoints that have been 
inactivated (executed) are reactivated. 

Sets a temporary breakpoint. When the break occurs, the original opcode is 
replaced in the program. 

A comma is used as a delimiter between specified breakpoint values. 



Examples 



modify software_breakpoints enable <RETURN> 

modify software_breakpoints set loopl end , loop2 end , 
0E40H <RETURN> 

modify software_breakpoints clear <RETURN> 
modify software_breakpoints set <RETURN> 



See Also 



The copy softwarejbreakpoints, display memory mnemonic, and display 
softwarejbreakpoints commands. 
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performance_measurement_end 



performance_measurement_end 



<RETURN> 



Examples 



See Also 



This command stores data previously generated by the 
performance_measurement_run command, in a file named "perf.out" in the 
current working directory. 

The file named "perf.out" is overwritten each time this command is executed. 
Current measurement data existing in the emulation system is not altered by this 
command. 



p&rformance_measurement_end <RETURN> 

The performance_measurement_initialize and performance_measurement_run 

commands. 

Refer to the "Making Software Performance Measurements" chapter for examples 
of performance measurement specification and use. 
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performance_measurement_initialize 



{^perf ormance_ measurement _ initializer- 



restore 





<FILE> 










activity 



duration 












— SYMB — 






<RETURN> 



This command sets up performance measurements. 

The emulation system will verify whether a symbolic database has been loaded. If 
a symbolic database has been loaded, the performance measurement is set up with 
the addresses of all global procedures and static symbols. If a valid database has not 
been loaded, the system will default to a predetermined set of addresses, which 
covers the entire emulation processor address range. 

The measurement will default to "activity" mode. 

Default values will vary, depending on the type of operation selected, and whether 
symbols have been loaded. 



The parameters are as follows: 



activity 



This option causes the performance measurement process to operate as though an 
option is not specified. 
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duration This option sets the measurement mode to "duration." Time ranges will default to a 

predetermined set (unless a user-defined file of time ranges is specified). 

<FILE> This represents a file you specify to supply user-defined address or time ranges to 

the emulator. 

global_symbols This option specifies that the performance measurement will be set up with the 
addresses of all global symbols and procedures in the source program. 

local_symbols_in This causes addresses of the local symbols to be used as the default ranges for the 
measurement. 

restore This option restores old measurement data so that a measurement can be continued 

when using the same trace command as previously used. 

-SYMB- This represents the source file that contains the local symbols to be listed. This also 

can be a program symbol name, in which case all symbols that are local to a 
function or procedure are used. See the SYMB syntax diagram. 



Examples 

p&rformance_msasurement_initializ6 <RETURN> 
p&rformance_msasurement_initializ& duration <RETURN> 

performancB_measurement_initialize local_symbols_in 

mod_name <RETURN> 

See Also The performance_measurement_run and performance_measurement_end 

commands. 

Refer to the "Making Software Performance Measurements" chapter for examples 
of performance measurement specification and use. 
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perf orma nce_measu rement_ru n 

(^performgnce_measurement_run^) 





<RETURN> 













This command begins a performance measurement. 

This command causes the emulation system to reduce trace data contained in the 
emulation analyzer, which will then be used for analysis by the performance 
measurement software. 

The default is to process data presently contained in the analyzer. 

The parameters are as follows: 

<COUNT> This represents the number of consecutive traces you specify. The emulation 

system will execute the trace command, process the resulting data, and combine it 
with existing data. This sequence will be repeated the number of times specified by 
the COUNT option. 

Note that the trace command must be set up correctly for the requested 
measurement. For an activity measurement, you can use the default trace 
command (trace <RETURN>). 

For a duration measurement, you must set up the trace specification to store only 
the points of interest. To do this, for example, you could enter: 

trace only <symbol_entry> or <symbol_exit> 



Examples 

p&rformancs_msasurement_run 10 <RETURN> 
p&rformance_msasuremen t_run < RE T URN > 

See Also The performance_measurement_end and performance_measurement_initialize 

commands. 
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Refer to the "Making Software Performance Measurements" chapter for examples 
of performance measurement specification and use. 
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pod_command 

(^pod_ command^- 





<PODCMD> 




<RETURN> 

















suspend 



<RETURN> 



Allows you to control the emulator through the direct HP 64700 Terminal Interface. 

The HP 64700 Card Cage contains a low-level Terminal Interface, which allows 
you to control the emulator's functions directly. You can access this interface 
using pod_command. The options to pod_command allow you to supply only 
one command at a time. Or, you can select a keyboard mode which gives you 
interactive access to the Terminal Interface. 

There are certain commands that you should avoid while using the Terminal 
Interface through pod_command. 



stty, po, xp 


Do not use. These commands will change the operation of the 
communications channel, and are likely to hang the Softkey 
Interface and the channel. 


echo, mac 


Using these may confuse the communications protocols in use 
on the channel. 


wait 


Do not use. The pod will enter a wait state, blocking access by 
the emulator/analyzer interface. 


init, pv 


These will reset the emulator pod and force an end 
release_system command. 


t 


Do not use. The trace status polling and unload will become 
confused. 



To see the results of a particular pod_command (the information returned by the 
emulator pod), you use display pod_command. 

Refer to the 68302 Emulator Terminal Interface User's Guide for information on 
using the Terminal Interface to control the emulator. 
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The parameters are as follows: 

keyboard Enters an interactive mode where you can simply type Terminal Interface 

commands (unquoted) on the command line. Use display pod_command to see 
the results returned from the emulator. 

<POD_CMD> Prompts you for a Terminal Interface command as a quoted string. Enter the 

command in quotes and press <RETURN>. 

Suspend This command is displayed once you have entered keyboard mode. Select it to stop 

interactive access to the Terminal Interface and return to the Graphical User 
Interface or Softkey Interface. 



Examples 



This example shows a simple interactive session with the Terminal Interface. 
display pod_command <RETURN> 

pod_command keyboard <RETURN> 

cf <RETURN> 



tsq <RETURN> 



tcq <RETURN> 



Enter suspend to return to the Graphical User Interface or Softkey Interface. 



See Also 



The display pod_command command. 

Also see the 68302 Emulator Terminal Interface User's Guide and the Terminal 
Interface on-line help information. 
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QUALIFIER 



From 



TRACE 



diagram 





RANGE 

















■To output of QUALIFIER 



or y«- 



TRACE diagram 



The QUALIFIER parameter is used with trace only, trace prestore, and 

TRIGGER to specify states captured during the trace measurement. 

You may specify a range of states (RANGE) or specific states (STATE) to be 
captured. You can continue to "or" states until the analyzer resources are depleted. 
You can use only one RANGE statement in the entire trace command. 

You can include "don't care numbers." These contain an "x" preceded and/or 
followed by a number. Some examples include lfxxh, 17x7o, and 01 lxxxlOb. 
"Don't care numbers" may be entered in binary, octal, or hexadecimal base. 

The default is to qualify on all states. 

The parameters are as follows: 

or This option allows you to specify multiple states (STATE) to be captured during a 

trace measurement. See the STATE syntax diagram. 

RANGE This allows you to specify a range of states to be captured during a trace 

measurement. See the RANGE syntax diagram. 

STATE This represents a unique state that can be a combination of address, data, status, and 

executed address values. See the STATE syntax diagram. 



Examples 

trace only address mod_name : read_input <RETURN> 

trace only address range mod_name : read_input thru 
output <RETURN> 
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trace only address range mod_name : clear thru read_input 
<RETURN> 



See Also The trace command. 
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RANGE 



From 

RANGE 

on 



QUALIFIER 



diagram 





< 



range 



not 



--EX-K-- 



thru 



— EXPR— - To outpul of RANGE 
on QUALIFIER diagram 



The RANGE parameter allows you to specify a condition for the trace 
measurement, made up of one or more values. 

The range option can be used for state qualifier labels. Range can only be used 
once in a trace measurement. 
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Refer to the "Qualifying Trigger and Store Conditions" section in the "Using the 
Emulation Analyzer" chapter for a list of the predefined values that can be assigned 
to the status state qualifiers. 

Expression types are "address" when none is chosen. 
The parameters are as follows: 

The value following this softkey is searched for on the lines that monitor the 
emulation processor's address bus. 

The value following this softkey is searched for on the lines that monitor the 
emulation processor's data bus. 

An expression is a combination of numeric values, symbols, operators, and 
parentheses, specifying an address, data, status, or executed address value. See the 
EXPR syntax diagram for details. 

This represents a defined external analyzer label. 

This specifies that the analyzer search for the logical "not" of the specified range 
(this includes any addresses not in the specified range). 

This indicates a range of addresses to be specified (--EXPR- thru -EXPR-). 

The value following this softkey is searched for on the lines that monitor other 
emulation processor signals. 

This indicates that the following address expression is the upper address in a range. 



CS 

edma 

grd 
ipl 



The following sofkeys are available if you have an emulation analyzer that has 64 
channels (for example, HP 64703/704/794): 

The value following this softkey is searched for on the lines that monitor processor 
signals CSO through CS3. 

A value of 0 qualifies the state as an external DMA cycle. A value of 1 qualifies 
the state as an internal DMA cycle. 

A value of 0 qualifies the state as a guarded memory access. 

The value following this softkey is searched for on the lines that monitor processor 
signals IPL2 through IPLO. 



pbclr 



A value of 0 qualifies the state as /BCLR active. 
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pberr A value of 0 qualifies the state as /BERR active. 

pbio The value following this softkey is searched for on the lines that monitor processor 

signals PB 1 1 through PB8. 

rom A value of 0 qualifies the state as a write to ROM. 

extra Combines the edma, pbclr, cs, pberr, grd, rom, pbio, and ipl softkeys. Some 

values you can specify following the extra softkey are: 

Examples See the trace command examples. 

See Also The trace command and the QUALIFIER syntax description. 
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reset 



reset ► <RETURN> 



This command suspends target system operation and reestablishes initial emulator 
operating parameters. 

The reset signal is latched when the reset command is executed and released by 
either the run or break command. 



See Also The break and run commands. 
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This command causes the emulator to execute a program. 

If the processor is in a reset state, run will cause the reset to be released. 

If the emulator is configured to run directly into user code out of reset, the monitor 
will not be entered and part of your debug environment may be temporarily 
disabled. A subsequent break into the monitor will restore it. See the "Enter 
monitor from reset?" question in the configuration menu for more information. 

If the from parameter and an address is specified, the processor will start running 
your program at that address. Otherwise, the run will occur from the address 
currently stored in the processor' s program counter. 

A run from reset command will reset the processor and then allow it to run. It is 
equivalent to entering a reset command followed by a run command. 

If the emulator is configured to participate in the READY signal on the CMB, then 
this emulator will release the READY signal so that it will go TRUE if all other 
HP 64700 emulators participating on that signal are also ready. See the 
cmb_execute command description. 

Qualifying a run command with an until parameter causes a software breakpoint to 
be set before the program is run. 

If you omit the address option (-EXPR-), the emulator begins program execution 
at the current address specified by the emulation processor program counter. If an 
absolute file containing a transfer address has just been loaded, execution starts at 
that address. 

The parameters are as follows: 
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Specifies an address for a temporary register breakpoint that will be programmed 
into one of the processor's two breakpoint registers. Up to two addresses may be 
specified. 

An expression is a combination of numeric values, symbols, operators, and 
parentheses, specifying a memory address. See the EXPR syntax diagram. 

The function code used to define the address space being referenced. See the syntax 
diagram for FCODE to see a list of the function codes available and for an 
explanation of those codes. 

This specifies the address from which program execution is to begin. 
This option resets the processor prior to running. 

This represents the starting address of the program loaded into emulation or target 
memory. The transfer address is defined in the linker map and is part of the symbol 
database associated with the absolute file. 

Causes a software breakpoint to be set at the specified address before the program 
is run. 



Examples 



run < RET URN > 



run from 81 OH <RETURN> 



run from COLD START <RETURN> 



run from transfer address until 910H <RETURN> 



See Also 



The step command. 
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SEQUENCING 



From trace 
syntax diagram 



fincL 



JALIFIER 




<oTIMES> 



the 



restart }— QUALIFIER 



Lets you specify complex branching activity that must be satisfied to trigger the 
analyzer. 

Sequencing provides you with parameters for the trace command that let you 
define branching conditions for the analyzer trigger. 

You are limited to a total of seven sequence terms, including the trigger, if no 
windowing specification is given. If windowing is selected, you are limited to a 
total of four sequence terms. 

The analyzer default is no sequencing terms. If you select the sequencer using the 
find_sequence parameter, you must specify at least one qualifying sequence term. 

The parameters are as follows: 

find_sequence Specifies that you want to use the analysis sequencer. You must enter at least one 

qualifier. 

QUALIFIER Specifies the address, data, status, or executed address value or value range that will 

satisfy this sequence term if looking for a sequence (find_sequence), or will restart 
at the beginning of the sequence (restart). See the QUALIFIER syntax pages for 
further information. 
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occurs Selects the number of times a particular qualifier must be found before the analyzer 

proceeds to the next sequence term or the trigger term. This option is not available 
when trace windowing is in use. See the WINDOW syntax pages. 

<#TIM ES> Prompts you for the number of times a qualifier must be found. 

then Allows you to add multiple sequence terms, each with its own qualifier and 

occurrence count. 

restart Selects global restart. If the analyzer finds the restart qualifier while searching for a 

sequence term, the sequencer is reset and searching begins for the first sequence 
term. 



Examples 

trace find_sequence Caller_3 then Write_Num restart 

anly . "anly . c" : line 57 trigger after Results+0c4h 
<RETURN> 

See Also The trace command and the QUALIFIER and WINDOW syntax descriptions. 
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Controls the display format for the data, memory, register, software breakpoint, and 
trace displays.With the set command, you can adjust the display format results for 
various measurements, making them easier to read and interpret. Formatting of 
source lines, symbol display selection and width, and update after measurement can 
be defined to your needs. 

The display command uses the set command specifications to format measurement 
results for the display window. Another option to the set command, <ENV_VAR> 
= <VALUE>, allows you to set and export system variables to the UNIX 
environment. 

The default display format parameters are the same as those set by the commands: 
set update 

set source off symbols off 

You can return the display format to this state by entering: 
set default 

The parameters are as follows: 

default This option restores all the set options to their default settings. 

<ENV_VAR> Specifies the name of a UNIX environment variable to be set. 

The equals sign is used to equate the <ENV_VAR> parameter to a particular value 
represented by <VALUE>. 

inverse video 

Off This displays source lines in normal video. 

on This highlights the source lines on the screen (dark characters on light background) 

to differentiate the source lines from other data on the screen. 
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langinfo In certain languages, you may have symbols with the same names but different 

types. For example, in IEEE695, you may have a file named main.c and a 
procedure named main. SRU would identify these as main(module) and 
main(procedure). The command display local_symbols_in main would cause an 
error message to appear (Ambiguous symbol: main(procedure, module)). Users of 
C tend to think the procedure is important and users of ADA tend to think the 
module is important. By entering "langinfo" and "C", SRU will interpret the above 
command to be main(procedure). With langinfo ADA, SRU will interpret the 
above command to be main(module). 

C Identifies ANSI C as the language so SRU can use the C hierarchy to disambiguate 

symbols. 

ADA Identifies ADA as the language so SRU can use the ADA hierarchy to 

disambiguate symbols. 

C_IEE695 Identifies C_IEEE-695 as the language so SRU can use the C_IEEE-695 hierarchy 

to disambiguate symbols. 



Note An alternate method for making the langinfo specification is to use the environment 

variable, HP64SYMORDER. By making the following entry in your .profile, the 
langinfo setting will always be C, for example. 

S HP64SYMORDER=C # I want to use the C disambiguating 

# hierarchy 

S export HP64SYMORDER # let children processes know 

# about it 



memory Sets update option for memory displays only. 

noupdate When using multiple windows or terminals, and specifying this option, the display 

buffer in that window or terminal will not update when a new measurement 
completes. Displays showing memory contents are not updated when a command 
executes that could have caused the values in memory to change (modify memory, 
load, etc.). 

This allows you to specify the number of source lines displayed for the actual 
processor instructions with which they correlate. Only source lines up to the 
previous actual source line will be displayed. Using this option, you can specify 
how many comment lines are displayed preceding the actual source line. The 
default value is 5. 



number_of_ 
source lines 
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This prompts you for the number of source lines to be displayed. Values in the 
range 1 through 50 may be entered. 



This option prevents inclusion of source lines in the trace and memory mnemonic 
display lists. 

This option displays source program lines preceding actual processor instructions 
with which they correlate. This enables you to correlate processor instructions with 
your source program code. The option works for both the trace list and memory 
mnemonic displays. 

This option displays only source lines. Processor instructions are only displayed in 
memory mnemonic if no source lines correspond to the instructions. Processor 
instructions are never displayed in the trace list. 



This prevents symbol display. 

This displays symbols. This option works for the trace list, memory, software 
breakpoints, and register step mnemonics. 

Displays only high level symbols, such as those available from a compiler. See the 
Symbolic Retrieval Utilities User's Guide for a detailed discussion of symbols. 

Displays only low level symbols, such as those generated internally by a compiler, 
or an assembly symbol. 

Displays all symbols. 

This option allows you to define the number of spaces inserted for tab characters in 
the source listing. 

Prompts you for the number of spaces to use in replacing the tab character. Values 
in the range of 2 through 15 may be entered. 

Sets update option for trace displays only. 

When using multiple windows or terminals, and specifying this option, the display 
buffer in that window or terminal will be updated when a new measurement 
completes. This is the default. Note that for displays that show memory contents, 
the values will be updated when a command executes that changes memory 
contents (such as modify memory, load, and so on). 
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<VALUE> 

width 
source 

label 

mnemonic 

symbols 
<WIDTH> 



Specifies the logical value to which a particular UNIX environment variable is to 
be set. 



This allows you to specify the width (in columns) of the source lines in the memory 
mnemonic display. To adjust the width of the source lines in the trace display, 
increase the widths of the label and/or mnemonic fields. 

This lets you specify the address width (in columns) of the address field in the trace 
list or label (symbols) field in any of the other displays. 

This lets you specify the width (in columns) of the mnemonic field in memory 
mnemonics, trace list and register step mnemonics displays. It also changes the 
width of the status field in the trace list. 

This lets you specify the maximum width of symbols in the mnemonic field of the 
trace list, memory mnemonic, and register step mnemonic displays. 

This prompts you for the column width of the source, label, mnemonic, or symbols 
field. 

Note that <CTRL>f and <CTRL>g may be used to shift the display left or right to 
display information which is off the screen. 



Examples 



set source on inverse_video on tabs_are 2 <RETURN> 

set symbols on width label 30 mnemonic 2 0 < RE TURN > 

set PRINTER = "lp -s" <RETURN> 

set HP64KSYMBPATH=" . filel :procl 

. f ile2 : proc2 : code_block_l " <RETURN> 



See Also 



The display data, display memory, display softwarejbreakpoints, and display 
trace commands. 
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specify 




This command prepares a run or trace command for execution, and is used with 
the cmb_execute command. 

When you precede a run or trace command with specify, the system does not 
execute your command immediately. Instead, it waits until until an EXECUTE 
signal is received from the Coordinated Measurement Bus or until you enter a 
cmb_execute command. 

If the processor is reset and no address is specified, a cmb_execute command will 
run the processor from the "reset" condition. 

Note that the run specification is active until you enter specify run disable. The 
trace specification is active until you enter another trace command without the 
specify prefix. 

The emulator will run from the current program counter address if no address is 
specified in the command. 
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disable 
from 

--EXPR- 

FCODE 



transfer_address 
run 



TRACE 



until 



The parameters are as follows: 

This option turns off the specify condition of the run process. 



This is used with the specify run from command. An expression is a combination 
of numeric values, symbols, operators, and parentheses, specifying a memory 
address. See the EXPR syntax diagram. 

The function code used to define the address space being referenced. See the syntax 
diagram for FCODE to see a list of the function codes available and for an 
explanation of those codes. 

This is used with the specify run from command, and represents the address from 
which the program will begin running. 

This option specifies that the emulator will run from either an expression or from 
the transfer address when a CMB EXECUTE signal is received. 

This option specifies that a trace measurement will be taken when a CMB 
EXECUTE signal is received. 

Specifies an address where program execution is to stop. The emulator will set a 
software breakpoint at this address and stop execution of your program when it 
reaches this address and enter the monitor. 



Examples 



specify run from START <RETURN> 

specify trace after address 1234H <RETURN> 



See Also 



The cmb_execute command. 
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This parameter lets you specify a trigger condition as a unique combination of 
address, data, status, and executed address values. 

The STATE option is part of the QUALIFIER parameter to the trace command, 
and allows you to specify a condition for the trace measurement. 

Refer to the "Qualifying Trigger and Store Conditions" section in the "Using the 
Emulation Analyzer" chapter for a list of the predefined values that can be assigned 
to the status state qualifiers. 
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The parameters are as follows: 



address 

and 
data 

--EXPR-- 

<external_label> 
not 

status 

<STATUS> 



This specifies that the expression following is an address value. This is the default, 
and is therefore not required on the command line when specifying an address 
expression. 

This lets you specify a combination of status and expression values when status is 
specified in the state specification. 

The value following this softkey is searched for on the lines that monitor the 
emulation processor's data bus. 

An expression is a combination of numeric values, symbols, operators, and 
parentheses, specifying an address, data, status, or executed address value. See the 
EXPR syntax diagram. 

This represents a defined external analyzer label. 

This specifies that the analyzer will search for the logical "not" of a specified state 
(this includes any address that is not in the specified state). 

The value following this softkey is searched for on the lines that monitor other 
emulation processor signals. 

This prompts you to enter a status value in the command line. Status values can be 
entered from softkeys or typed into the keyboard. Numeric values may be entered 
using symbols, operators, and parentheses to specify a status value. See the EXPR 
syntax diagram. 



Examples 



trace before status write <RETURN> 



trace about address 1000H status write <RETURN> 



See the trace command examples. 



See Also 



The trace command and the QUALIFIER syntax description. 
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from 





— EXPR— 

















= i(ET..ii\ = 



silently 



The step command allows sequential analysis of program instructions by causing 
the emulation processor to execute a specified number of assembly instructions or 
source lines. 

You can display the contents of the processor registers, trace memory, and 
emulation or target memory after each step command. 

Source line stepping is implemented by single stepping assembly instructions until 
the next PC is beyond the address range of the current source line. When 
attempting source line stepping on assembly code (with no associated source line), 
stepping will complete when a source line is found. Therefore, stepping only 
assembly code may step forever. To abort stepping, press <CTRL>c. 

When displaying memory mnemonic and stepping, the next instruction that will 
step is highlighted. The memory mnemonic display autopages to the new address if 
the next PC goes outside of the currently displayed address range. This feature 
works even if stepping is performed in a different emulation window than one 
displaying memory mnemonic. 

If no value is entered for <NUMBER> times, only one step instruction is executed 
each time you press <RETURN>. Multiple instructions can be executed by holding 
down the <RETURN> key. Also, the default step is for assembly code lines, not 
source code lines. 
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-EXPR- 
FCODE 

from 

<NUMBER> 
silently 



transfer address 



source 



If the from address option (defined by --EXPR- or transfer_address) is omitted, 
stepping begins at the next program counter address. 

The parameters are as follows: 

An expression is a combination of numeric values, symbols, operators, and 
parentheses specifying a memory address. See the EXPR syntax diagram. 

The function code used to define the address space being referenced. See the syntax 
diagram for FCODE to see a list of the function codes available and for an 
explanation of those codes. 

Use this option to specify the address from which program stepping begins. 

This defines the number of instructions that will be executed by the step command. 
The number of instructions to be executed can be entered in binary (B), octal (O or 
Q), decimal (D), or hexadecimal (H) notation. 

When you specify a number of steps, this option updates the register step 
mnemonic only after stepping is complete. This will speed up stepping of many 
instructions. The default is to update the register step mnemonic after each 
assembly instruction (or source line) executes (if stepping is performed in the same 
window as the register display). 

This represents the starting address of the program you loaded into emulation or 
target memory. The transfer_address is defined in the linker map. 

This option performs stepping on source lines. 



Examples 



step <RETURN> 
step from 81 OH <RETURN> 
step 5 source <RETURN> 
step 2 0 silently <RETURN> 
step 4 from main <RETURN> 



See Also 



The display registers, display memory mnemonic, and set symbols commands. 
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stop_trace 



stop_trace 



<RETURN> 



This command terminates the current trace and stops execution of the current 
measurement. 

The analyzer stops searching for trigger and trace states. If trace memory is empty 
(no states acquired), nothing will be displayed. 

See Also The trace command. 
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store 
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-EXPR- 
FCODE 

<FILE> 



This command lets you save the contents of specific memory locations in an 
absolute file. You also can save trace memory contents in a trace file. 

The store command creates a new file with the name you specify, if there is not 
already an absolute file with the same name. If a file represented by <FILE> 
already exists, you must decide whether to keep or delete the old file. If you 
respond with yes to the prompt, the new file replaces the old one. If you respond 
with no, the store command is canceled and no data is stored. 

The transfer address of the absolute file is set to zero. 

The parameters are as follows: 

This is a combination of numeric values, symbols, operators, and parentheses, 
specifying a memory address. See the EXPR syntax diagram. 

The function code used to define the address space being referenced. See the syntax 
diagram for FCODE to see a list of the function codes available and for an 
explanation of those codes. 

This represents a file name you specify for the absolute file identifier or trace file 
where data is to be stored. If you want to name a file beginning with a number, you 
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store 

must precede the file name with a backslash (\) so the system will recognize it as a 
file name. 

This causes selected memory locations to be stored in the specified HP64000 
format file with a .X extension. 

This allows you to specify that ranges of memory be stored. 

Use this in the store memory command to separate memory locations from the file 
identifier. 

This option causes the current trace data to be stored in the specified file with a .TR 
extension. 

This option stores the current trace specification in the specified file with a .TS 
extension. 

A comma separates memory expressions in the command line. 



Examples 



store memory 8 0 OH thru 2 0FFH to TEMP 2 <RETURN> 
store memory EXEC thru DONE to \12.10 <RETURN> 
store trace TRACE <RETURN> 
store trace_spec TRACE <RETURN> 



See Also 



The display memory, display trace, and load commands. 
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This parameter is a symbolic reference to an address, address range, file, or other 
value. 

Note that if no default file was defined by executing the command display 
local_symbols_in --SYMB--, or with the cws command, a source file name 
(<FILE>) must be specified with each local symbol in a command line. 

Symbols may be: 

• Combinations of paths, filenames, and identifiers defining a scope, or 
referencing a particular identifier or location (including procedure entry and 
exit points). 

• Combinations of paths, filenames, and line numbers referencing a particular 
source line. 

• Combinations of paths, filenames, and segment identifiers identifying a 
particular PROG, DATA or COMN segment or a user-defined segment. 

The Symbolic Retrieval Utilities (SRU) handle symbol scoping and referencing. 
These utilities build trees to identify unique symbol scopes. 

If you use the SRU utilities to build a symbol database before entering the 
emulation environment, the measurements involving a particular symbol request 
will occur immediately. If you then change a module and reenter the emulation 
environment without rebuilding the symbol database, the emulation software 
rebuilds the changed portions of the database in increments as necessary. 

Further information regarding the SRU and symbol handling is available in the 
Symbolic Retrieval Utilities User's Guide. Also refer to that manual for 
information on the HP64KSYMBPATH environment variable. 

The last symbol specified in a display local_symbols_in — SYMB-- command, or 
with the cws command, is the default symbol scope. The default is "none" if no 
current working symbol was set in the current emulation session. 

You also can specify the current working symbol by typing the cws command on 
the command line and following it with a symbol name. The pws command 
displays the current working symbol on the status line. 

Display memory mnemonic also can modify the current working symbol. 
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<FILENAME> 



line 

<LINE#> 
<IDENTIFIER> 
SCOPE 

segment 

<SEG_NAME> 
(<TYPE>) 



filename 
module 

procedure 

static 

task 



The parameters are as follows: 

This is an UNIX path specifying a source file. If no file is specified, and the 
identifier referenced is not a global symbol in the executable file that was loaded, 
then the default file is assumed (the last absolute file specified by a display 
local_symbols_in command). A default file is only assumed when other parameters 
(such as line) in the --SYMB-- specification expect a file. 

This specifies that the following numeric value references a line number in the 
specified source file. 

Prompts you for the line number of the source file. 

Identifier is the name of an identifier as declared in the source file. 

Scope is the name of the portion of the program where the specified identifier is 
defined or active (such as a procedure block). 

This indicates that the following string specifies a standard segment (such as 
PROG, DATA, or COMN) or a user-defined segment in the source file. 

Prompts you for entry of the segment name. 

When two identifier names are identical and have the same scope, you can 
distinguish between them by entering the type (in parentheses). Do not type a space 
between the identifier name and the type specification. The type will be one of the 
following: 

Specifies that the identifier is a source file. 

These refer to module symbols. For Ada, they are packages. Other language 
systems may allow user-defined module names. 

Any procedure or function symbol. For languages that allow a change of scope 
without explicit naming, SRU assigns an identifier and tags it with type procedure. 

Static symbols, which includes global variables. The logical address of these 
symbols will not change. 

Task symbols, which are specifically defined by the processor and language system 
in use. 

A colon is used to specify the UNIX file path from the line, segment, or symbol 
specifier. When following the file name with a line or segment selection, there 
must be a space after the colon. For a symbol, there must not be a space after the 
colon. 
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Examples The following short C code example should help illustrate how symbols are 

maintained by SRU and referenced in your emulation commands. 

File /users/dave/control.c: 

int *port_one; 
main () 

j 

int port_value; 

port_ptr = port_one; 
port_value = 10; 

process_port (port_ptr, port_value) ; 
} /* end main */ 



File /system/projectl/porthand.c: 

#include "utils.c" 

void process_port (int *port_num, int port_data) 

{ 

static int i; 
static int i2; 

for (i = 0; i <= 64; i++) { 
i2 = i * 2; 

*port_num = port_data + i2; 
delay (); 
{ 

static int i; 
i = 3; 

port_data = port_data + i; 
} 

} 

} /* end of process_port */ 



File /system/projectl/utils.c: 

delay () 
{ 

int i, j; 
int waste_time; 

for (i = 0; i < 
for (j = 0; j 
waste_time 
} /* end delay */ 



= 256000; i++) 

<= 256000; j++) 
= 0; 
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The symbol tree as built by SRU might appear as follows, depending on the object 
module format and compiler used: 




Note that SRU does not build tree nodes for variables that are dynamically 
allocated on the stack at run-time, such as i and j within the delay () procedure. 
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SRU has no way of knowing where these variables will be at run time and therefore 
cannot build a corresponding symbol tree entry with run time address. 

Here are some examples of referencing different symbols in the above programs: 

control . c : main 

control . c :port_one 

port hand . c : utils . c : delay 

The last example above only works with IEEE-695 object module format; the HP 
object module format does not support referencing of include files that generate 
program code. 

port hand . c : process_port . i 

port hand . c : process_port . BL0CK_1 . i 

Notice how you can reference different variables with matching identifiers by 
specifying the complete scope. You also can save typing by specifying a scope with 
cws. For example, if you are making many measurements involving symbols in the 
file porthand.c, you could specify: 

cws porthand. c :process_port 

Then: 

i 

BL0CK_1 . i 

are prefixed with porthand.c: process_port before the database lookup. 

If a symbol search with the current working symbol prefix is unsuccessful, the last 
scope on the current working symbol is stripped. The symbol you specified is then 
retested with the modified current working symbol. Note that this does not change 
the actual current working symbol. 

For example, if you set the current working symbol as 

cws porthand. c :process_port . BL0CK_1 
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and made a reference to symbol i2, the retrieval utilities attempt to find a symbol 
called 

port hand . c : process_port . BLOCK_l . i2 

which would not be found. The symbol utilities would then strip BLOCK_l from 
the current working symbol, yielding 

port hand . c : process_port . i2 
which is a valid symbol. 

You also can specify the symbol type if conflicts arise. Although not shown in the 
tree, assume that a procedure called port_one is also defined in control.c. This 
would conflict with the identifier port_one which declares an integer pointer. SRU 
can resolve the difference. You must specify: 

control . c :port_one (static) 

to reference the variable, and 

control . c :port_one (procedure) 

to reference the procedure address. 

The copy local_symbols_in and display local_symbols_in commands. 

Also refer to the Symbolic Retrieval Utilities User's Guide for further information 
on symbols. 
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TRIGGER 









only 



QUALIFIER 



prestore 




QUALIFIER 



anything 



-"-A>reak_on_triggeM- 
"-(repetitively^ ^ 



<RETURN> 



This command allows you to trace program execution using the emulation analyzer. 

Note that the options shown can be executed once for each trace command. Refer 
to the TRIGGER and QUALIFIER diagrams for details on setting up a trace. 

You can perform analysis tasks either by starting a program run and then specifying 
the trace parameters, or by specifying the trace parameters first and then initiating 
the program run. Once a trace begins, the analyzer monitors the system busses of 
the emulation processor to detect the states specified in the trace command. 

When the trace specification is satisfied and trace memory is filled, a message will 
appear on the status line indicating the trace is complete. You can then use display 
trace to display the contents of the trace memory. If a previous trace list is on 
screen, the current trace automatically updates the display. If the trace memory 
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trace 



again 



anything 
arm_trig2 



break_on_trigger 

modify_command 
on_halt 

only 

prestore 



contents exceed the page size of the display, the <NEXT>, <PREV>, <Up arrow>, 
or <Down arrow> keys may be used to display all the trace memory contents. You 
also can press <CTRL>f and <CTRL>g to move the display left and right. 

You can set up trigger and storage qualifications using the specify trace command. 
The analyzers will begin tracing when a cmb_execute command executes, which 
causes an EXECUTE signal on the Coordinated Measurement Bus. 

The analyzer will trace any state by default. 

The parameters are as follows: 

This option repeats the previous trace measurement. It also begins a trace 
measurement with a newly loaded trace specification. (Using trace without the 
again parameter will start a trace with the default specification rather than the 
loaded specification.) 

This causes the analyzer to capture any type of information. 

This option allows you to specify the external trigger as a trace qualifier, for 
coordinating measurements between multiple HP 64700s, or an HP 64700 and 
another instrument. 

Before arm_trig2 can appear as an option, you must modify the emulation 
configuration interactive measurement specification. When doing this, you must 
specify that either BNC or CMBT drive trig2, and that the analyzer receive trig2. 
See the chapter on "Making Coordinated Measurements" for more information. 

This stops target system program execution when the trigger is found. The 
emulator begins execution in the emulation monitor. When using this option, the 
on_halt option cannot be included in the command. 

This recalls the last trace command that was executed. 

When using this option, the analyzer will continue to capture states until the 
emulation processor halts or until a stop_trace command is executed. When this 
option is used, the break_on_trigger, repetitively, and TRIGGER options cannot 
be included in the command. 

This option allows you to qualify the states that are stored, as defined by 
QUALIFIER. 

This option instructs the analyzer to save specific states that occur prior to states 
that are stored (as specified with the "only" option). 
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QUALIFIER 



repetitively 



SEQUENCING 



TRIGGER 



WINDOW 



This determines which of the traced states will be stored or prestored in the trace 
memory for display upon completion of the trace. Events can be selectively saved 
by using trace only to enter the specific events to be saved. When this is used, 
only the indicated states are stored in the trace memory. See the QUALIFIER 
syntax. 

This initiates a new trace after the results of the previous trace are displayed. The 
trace will continue until a stop_trace or a new trace command is issued. When 
using this option, you cannot use the on_halt option. 

Allows you to specify up to seven sequence terms including the trigger. The 
analyzer must find each of these terms in the given order before searching for the 
trigger. You are limited to four sequence terms if windowing is enabled. See the 
SEQUENCING syntax pages for more details. 

This represents the event on the emulation bus to be used as the starting, ending, or 
centering event for the trace. See the TRIGGER syntax diagram. When using this 
option, you cannot include the on_halt option. 

Selectively enables and disables analyzer operation based upon independent enable 
and disable terms. This can be used as a simple storage qualifier. Or, you may use 
it to further qualify complex trigger specifications. See the WINDOW syntax 
pages for details. 



Examples 



trace after 1000H <RETURN> 

trace only address range 1000H thru 1004H <RETURN> 

trace after address 1000H occurs 2 only address range 
100 OH thru 10 04H break_on_trlgger <RETURN> 



See Also 



The copy trace, display trace, load trace, load trace_spec, specify trace, store 
trace, and store trace_spec commands. 
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TRACE 




diagram 



This parameter lets you define where the analyzer will begin tracing program 
information during a trace measurement. 

A trigger is a QUALIFIER. When you include the occurs option, you can specify 
the trigger to be a specific number of occurrences of a QUALIFIER (see the 
QUALIFIER syntax diagram). 

The default is to trace after any state occurs once. 

The parameters are as follows: 

about This option captures trace data leading to and following the trigger qualifier. The 

trigger is centered in the trace listing. 

after Trace data is acquired after the trigger qualifier is found. 

before Trace data is acquired prior to the trigger qualifier. 

occurs This specifies a number of qualifier occurrences of a range or state on which the 

analyzer is to trigger. 

QUALIFIER This determines which of the traced states will be stored in trace memory. 

<#TIM ES> This prompts you to enter a number of qualifier occurrences. 



474 



Chapter 12: Emulator/Analyzer Interface Commands 

TRIGGER 

Examples 

trace after MAIN <RETURN> 

trace after 1000H then data 5 <RETURN> 

Also see the trace command examples. 

See Also The trace command. 

Also, refer to the "Making Coordinated Measurements" chapter. 
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wait 




This command allows you to present delays to the system. 

The wait command can be an enhancement to a command file, or to normal 
operation at the main emulation level. Delays allow the emulation system and 
target processor time to reach a certain condition or state before executing the next 
emulation command. 

The wait command does not appear on the softkey labels. You must type the wait 
command into the keyboard. After you type wait, the command parameters will be 
accessible through the softkeys. 

The system will pause until it receives a <CTRL>c signal. 

Note that if set intr <CTRL>c was not executed on your system, <CTRL>c 
normally defaults to the backspace key. See your UNIX system administrator for 
more details regarding keyboard definitions. 

The parameters are as follows: 

measurement This causes the system to pause until a pending measurement completes (a trace 

_COmplete data upload process completes), or until a <CTRL>c signal is received. If a 

measurement is not in progress, the wait command will complete immediately. 

or This causes the system to wait for a <CTRL>c signal or for a pending measurement 

to complete. Whichever occurs first will satisfy the condition. 
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seconds This causes the system to pause for a specific number of seconds. 

<TIME> This prompts you for the number of seconds to insert for the delay. 

Note that a wait command in a command file will cause execution of the command 
file to pause until a <CTRL>c signal is received, if <CTRL>c is defined as the 
interrupt signal. Subsequent commands in the command file will not execute while 
the command file is paused. You can verify whether the interrupt signal is defined 
as <CTRL>c by typing set at the system prompt. 



Examples 

wait <RETURN> 

wait 5; wait measurement_complBte <RETURN> 
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WINDOW 



From trace 
syntax diagram 




Lets you select which states are stored by the analyzer. 

WINDOW allows you to selectively toggle analyzer operation. When enabled, the 
analyzer will recognize sequence terms, trigger terms, and will store states. When 
disabled, the analyzer is effectively off, and only looks for a particular enable term. 

You specify windowing by selecting an enable qualifier term; the analyzer will 
trigger or store all states after this term is satisfied. If the disable term occurs after 
the analyzer is enabled, the analyzer will then stop storing states, and will not 
recognize trigger or sequence terms. You may specify only one enable term and 
one disable term. 

The analyzer defaults to recognizing all states. If you specify enable, you must 
supply a qualifier term. If you then specify disable, you must specify a qualifier 
term. 

The parameters are as follows: 

disable Allows you to specify the term which will stop the analyzer from recognizing states 

once the enable term has been found. 

enable Allows you to specify the term which will enable the analyzer to begin monitoring 

states. 

QUALIFIER Specifies the actual address, data, status value or range of values that cause the 

analyzer to enable or disable recognition of states. Note that the enable qualifier 
can be different from the disable qualifier. Refer to the QUALIFIER syntax pages 
for further details on analyzer qualifier specification. 



Examples 

trace enable _rand disable Oecch <RETURN> 
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WINDOW 

See Also The trace command and the SEQUENCING and QUALIFIER syntax descriptions. 
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Error Messages 



This chapter contains a list of error messages that may occur while operating the 
emulator and analyzer. 

The error log records error messages received during the emulation session. You 
may want to display the error log to view the error messages. Sometimes several 
messages will be displayed for a single error to help you locate a problem quickly. 
To prevent overrun, the error log purges the oldest messages to make room for the 
new ones. 

To display the error log: 

display error_log < RET URN > 

Error messages are grouped into the following categories: 

• Graphical/Softkey Interface Messages - Unnumbered 

• Graphical/Softkey Interface Messages - Numbered 

• Terminal Interface Messages 

Note that Terminal Interface messages are passed along to the Graphical User 
Interface (or Softkey Interface) and appear, with numbers, in the error log display. 



Graphical/Softkey Interface Messages - 
Unnumbered 



Address range too small for request - request truncated 

Cause: Too small of an address range is specified in a modify memory command. 
Action: Specify a larger memory range. 

Cannot create module file: 

Cause: Insufficient disk space for the module file. 
Action: Check disk space under $HP64000. 

Cannot start. Ending previous session, try again 

Cause: The host system could not start a new emulation session, and is ending the 
previous session. 

Action: After the previous session has ended, try starting a new emulation session. 
If that fails, try "emul700 -u <logical name>" to unlock the emulator and cycle 
power, if needed. 

Cannot start. Pod initialization failed 

Cause: The host system could not start a new emulation session because it could 
not initialize the emulator. 

Action: Cycle power on the emulator; verify that there are no red lights on the front 
of the emulator. You may need to run the Terminal Interface "pv" command to 
verify that the emulator is functioning properly before starting a new session. 

Configuration not valid, restoring previous configuration 
Configuration not valid, restoring default configuration 

Cause: The modifications you tried to make to the emulator configuration are not 
valid, so the host system restored the previous configuration. 

Action: See the "Configuring the Emulator" chapter for more information about the 
emulator configuration items and their settings. 
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Configuration process QUIT 

Cause: The configuration process ended because <CTRL> "\" (SIGQUIT signal) 
was encountered. This is an easy way to exit configuration without saving any 
changes. 

Action: Try starting the emulation session again. If the problem persists, you may 
need to cycle power on the emulator. 

Connecting to <LOGICAL NAME> 

Cause: This is a status message. The host system is making a communication 
connection to the emulator whose logical name is defined in 
$HP64000/etc/64700tab.net or $HP64000/etc/64700tab. 

Continue load failed 

Cause: The host system could not continue the previous emulation session because 
it could not load the continue file. 

Action: Try again. If the failure continues, call your HP Service Representative. 
Continuing previous session, continue file loaded 

Cause: This is a status message. An emulation session which was ended earlier 
with the end command has been restarted. The host system reported that the session 
was continued (using settings from the previous session) and that the continue file 
loaded properly. 

Continuing previous session, user interface defaulted 

Cause: The previous emulation session was continued and the Softkey Interface 
was set to the default state. 

Could not create default configuration 

Cause: The host system could not create a default configuration for the emulation 
session. 

Action: Check disk space under $HP64000 and verify proper software installation. 

Could not create CONFIGURATION BINARY FILENAME> 

Cause: The system could not create a binary emulation configuration file (file.EB). 
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Action: Check the file.EB write permission and verify that the specified directory 
exists and is writeable. 

Could not exec configuration process 

Cause: The host system could not fork the configuration process or could not 
execute the configuration process. 

Action: Make sure that the host system is operating properly, and that all Softkey 
Interface files were loaded properly during the installation process. Try starting the 
emulation session again. 

Could not load default configuration 

Cause: The host system could not load the default configuration into the emulator. 

Action: Cycle power on the emulator and run the Terminal Interface "pv" 
(performance verification) command on the emulator to verify that it is functioning 
properly. Also, verify proper software installation. If loading default configuration 
still fails, then call your HP 64000 representative. 

CONFIGURATION FILENAME> does not exist 

Cause: The configuration file you are trying to load does not exist. 

Action: Try the load configuration command again using a valid configuration file 
name. 

Don't care number unexpected 

Cause: While defining an expression in your command, you included a don't care 
number (a binary, octal, decimal, or hexadecimal number containing "x"), which 
was not expected. Don't care numbers are not valid for all commands. See the 
EXPR command syntax for more information about expressions. 

Emulation analyzer defaulted to delete label 

Cause: Analyzer trace labels were changed or modified while labels were in use in 
the trace specification. 

Action: Enter the previous trace specification and try again. 
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Emul700dmn continuation failed 

Cause: Communication between the emulator and the host system to continue the 
emulation session failed. 

Action: Check the data communication switch settings on the rear panel of the 
HP 64700 series emulator. If necessary, refer to the HP 64700 Installation/Service 
Guide. 

Emul700dmn executable not found 

Cause: The emulation session could not begin because the host system could not 
locate the HP 64700 emulator daemon process executable. 

Action: Make sure that software installation is correct. Then try starting the 
emulator again. 

Emul700dmn failed to start 

Cause: The emulation session could not begin because the host system could not 
start the HP 64700 emulator daemon process. 

Action: Make sure there is sufficient disk space under $HP64000. Make sure the 
host system is operating properly, that all Softkey Interface software has been 
loaded correctly, and the data communication switch settings on the emulator rear 
panel match the settings in the $HP64000/etc/64700tab.net (or 64700tab) file. 

Emul700dmn message too large 
Emul700dmn message too small 
Emul700dmn queue and/or semaphores missing 
Emul700dmn queue failure 
Emul700dmn error in file operation 
Emul700dmn queue full 

Cause: The HP 64700 emulator daemon process command was too large for the 
host system to process. 

Action: You must press end_release_system to exit this emulation session 
completely; then start a new session. Make sure the host system is operating 
properly, that all Softkey Interface software has been loaded correctly, and the data 
communication switch settings on the emulator rear panel match the settings in the 
$HP64000/etc/64700tab.net (or 64700tab) file. You may have to cycle power and 
use emul700 -u ,logical name> to unlock the system. 
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Emul700dmn sem op failed, perhaps kernel limits too low 

Cause: The host system could not start the emulation session; there may be too 
many processes running on the host system. 

Action: Make sure the host system is operating properly, and is not overloaded with 
currently executing processes. Stop or remove some processes on the system. Also, 
verify that the semaphore capabilities have been installed in the UNIX kernel. Then 
try starting the emulation session again. 

Emul700dmn version incompatible with this product 

Cause: The emulation session could not begin because the version of the HP 64700 
emulator daemon executable on host system is not compatible with the version of 
the Softkey Interface you are using. 

Action: Make sure the software has been properly installed. Then try starting the 
emulator again. 

<LOGICAL NAME>: End, continuing 

Cause: This is a status message. The emulation session is being exited with the end 
command. When you restart the emulation session later, it will continue using the 
same settings as in the session you just ended. The emulator logical name is located 
in the $HP64000/etc/64700tab.net (or 64700tab) file. 

<LOGICAL NAME>: End, released 

Cause: This is a status message. The emulation session is being exited with the end 
release_system command. When the session has ended, the emulator is released, 
meaning that others can access and use it. When you restart the emulation session 
later, the new session will use all default settings. The emulator logical name is 
located in the $HP64000/etc/64700tab.net (or 64700tab) file. 

Ending released 

Cause: This is a status message. The emulation session is being exited with the end 
release_system. The emulator will be released for others to access and use it. 

Error: display size is <LINES> lines by <COLUMNS> columns. It must be at 
least 24 by 80. 

Cause: You tried to specify an incorrect window size. 
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Action: Set the window size accordingly, then start the emulation session. The size 
of the window must be a minimum of 24 lines (rows) by 80 columns to operate an 
emulation session. 

Error in configuration process 
Error starting configuration process 

Cause: Unexpected configuration error. 

Action: Verify proper software installation and call your HP 64000 representative. 

Fatal error from function <ADDRESS OF FUNCTION> 

Cause: This is an unexpected fatal system error. 

Action: Cycle power on the emulator and start again. If this is a persistent problem, 
call your HP 64000 representative. 

File could not be opened 

Cause: You tried to store or load trace data to a file with incorrect permission. Or 
the analyzer could not find the file you specified, or else there were already too 
many files open when you entered your command. 

Action: Check the directory and file for correct read and write permission. Specify 
a file that is accessible to the analyzer. Close the other files that are presendy open. 

File perf.out does not exist 

Cause: You tried to execute the "restore" command to continue a previous software 
performance measurement, and the SPMT software found that no 
"performance_measurement_end" command was previously executed to create a 
file from which "restore" could be performed. 

Action: Execute a new SPMT measurement. 

File perf.out not generated by measurement software 

Cause: The faile named perf.out exists in the current directory, but it was not 
created by the "performance_measurement_end" command. 

Action: Rename the old "perf.out" file, or move it to another directory. 
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HP64700 I/O channel semaphore failure: <string> 

Cause: Semaphore (ipc) facility not installed. 
Action: Reconfigure the kernel to add ipc facility. 

HP 64700 I/O error; communications timeout 

Cause: This is a communication failure. 

Action: Check power to the emulator and check that all cables are connected 
properly. If you are using LAN and heavy LAN traffic is present, try setting the 
environment variable to HP64700TIMEOUT="30" (or larger if needed). The value 
is the number of seconds before timeout occurs. Then try running again. 

HP64700 I/O error; connection timed out 

Cause: A user abort occurred while attempting to connect via LAN. 
Action: Possibly connecting to an emulator many miles away, be patient. 

HP 64700 I/O error; power down detected 

Cause: The emulator power was cycled. 

Action: Do not do this during a user interface session; this may force the user 
interface to end immediately. 

HP64700 I/O channel busy; communications timed out 

Cause: The communications channel is in use for an unusually long period of time 
by another command. 

Action: try again later. 
Illegal status combination 

Cause: You tried to specify combinations of status qualifiers in expressions 
incorrectly when entering commands. 

Action: Refer to the "Emulator/ Analyzer Interface Commands" chapter for 
information about syntax of commands. 
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Illegal symbol name 

Cause: You tried to specify incorrect symbol names when entering commands. 

Action: Specify correct symbol names. To see global symbol names, use the 
display global_symbols command. To see local symbol names, use the 
display local_symbols_in <SYMB> command. 

Initialization failed 

Cause: The emulator could not be initialized. 

Action: Make sure your data communication switch settings are correct, and that all 
Softkey Interface software has been loaded properly. Cycle power on the emulator, 
then try starting up the emulation session again. 

Initialization load failed 

Cause: The emulator could not be initialized. 

Action: Make sure your data communication switch settings are correct, and that all 
Softkey Interface software has been loaded properly. Cycle power on the emulator, 
then try starting up the emulation session again. 

Initializing emulator with default configuration 

Cause: This is a status message. The host system started the emulation session and 
initialized the emulator using the default configuration. The emulator is probably 
operating correctly. 

Initializing user interface with default config file 

Cause: This is a status message. The host system started the emulation session and 
Softkey Interface using the default configuration file. The emulator is probably 
operating correctly. 

Insufficient emulation memory, memory map may be incomplete 

Cause: You can map only the amount of emulation memory available in your 
emulator. Trying to map additional unavailable memory may cause information to 
be missing from your memory map. 

Action: Modify your configuration and update the memory map to correctly reflect 
the amount of emulation memory available. 
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Invalid answer in CONFIGURATION FILENAME> ignored 

Cause: You must provide acceptable responses to questions in the configuration file 
(file.EA). The emulator ignored the incorrect response. Incorrect responses may 
appear in configuration files when you have saved the configuration to a file, edited 
it later, and tried reloading it into the emulator. This may also occur if you have 
loaded a configuration file that you created while using another emulator, and the 
response differs from the response required for this emulator. 

Action: Examine your configuration file to check for inappropriate responses to 
configuration file questions. 

Inverse assembly file <INVERSE ASSEMBLER FILENAME> could not be 
loaded 

Inverse assembly file <INVERSE ASSEMBLER FILENAME> not found, 
<filename> 

Inverse assembly not available 

Cause: The file does not exist. 

Action: Reload your interface and/or real-time operating system software. 
Inverse assembly not available 

Cause: The inverse assembler for your emulator is missing. 
Action: Verify proper software installation. 

Joining session already in progress, continue file loaded 

Cause: This is a status message. When operating the emulator in multiple 
windows, a new emulation session is "joined" to a current session. In this case, the 
new session was able to continue because the continue file loaded properly. 

Joining session already in progress, user interface defaulted 

Cause: When operating the emulator in multiple windows, a new emulation session 
is "joined" to a current session. In this case, the new session used the user interface 
default selections. 



491 



Chapter 13: Error Messages 

Graphical/Softkey Interface Messages - Unnumbered 

Load aborted 

Cause: While loading a file into the emulator, an event occurred that caused the 
host system to stop the load process. 

Action: Use the display errorjog command to view any errors. If the problem 
persists, make sure the host system and emulator are operating properly, and that 
you are trying to load an acceptable file. See the "Emulator/Analyzer Interface 
Commands" chapter for information about the load command. 

Load completed with errors 

Cause: While loading a file into the emulator, one or more events occurred that 
caused errors during the load process. 

Action: Use the display errorjog command to view any errors. You may need to 
modify the configuration and map memory before you load the file again. If the 
problem persists, make sure the host system and emulator are operating properly, 
and that you are trying to load an acceptable file. 

Measurement system not found 

Cause: You tried to end the current emulation session and select another 
measurement system module which could not be located by the host system. 

Action: Either try the end select measurement_system command again or end and 
release the emulation session. 

Memory allocation failed, ending released 

Cause: This is a fatal system error because the emulation session was unable to 
allocate memory. 

Action: You may need to reconfigure your UNIX kernel to increase the per process 
maximum memory limit and available swap space. Reboot your UNIX system and 
try starting a new session again. 

Memory block list unreadable 

Memory range overflow 

Cause: A modify memory command is attempted that would cross physical 0. 
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Action: Limit the modify memory command to not overflow physical 0 or break 
the command into two separate modify commands. 

No address label defined 

Cause: The address trace label was somehow removed in the terminal interface 
using the tlb command. 

Action: End session and start again. 

No more processes may be attached to this session 

Cause: You can operate an emulator in four windows. Each time you start the 
emulator in another window, a new process is attached to the current session. 

Action: Do not try to use more than four windows. Once you have started the 
emulator in four windows, you have reached the maximum number of processes 
allowed for that emulator. 

Not an absolute file 

No absolute file: <file> 

No absolute file, No database: <file> 

Cause: You tried to load a file into the emulator that is not an executable or 
absolute file, so the host system stopped the load process. 

Action: Try your command again, and make sure you specify a valid absolute file 
name to be loaded. 

No symbols loaded 

Cause: You tried to step through lines in the source file before symbols are loaded. 

Action: Load symbols and try again, or use step with the "source" option (i.e. step 
assembly language program). 

No valid trace data 

Cause: You tried to store trace data before a trace was completed. 

Action: Wait until valid trace data is available before attempting to store a trace. 
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Not a valid trace file - load aborted 

Cause: You tried to load a file.TR that was not created by the emulation session. 
Action: Only load trace data files that were created by the emulator. 

Not compatible trace file - load aborted 

Cause: You tried to load a file.TR that was created by another type of emulator. 
Action: Only load trace data files that were created by the same type of emulator. 

Number of lines not in range: 1 <= valid lines <= 50 

Cause: You tried to enter a number of lines that was outside the range from 1 to 50. 
Action: Try entering the command again using a valid number of lines. 

Number of spaces not in range: 2 <= valid spaces <= 15 

Cause: You tried to enter a number of spaces outside the range from 2 to 15. 
Action: Try entering the command again using a valid number of spaces. 

opcode extends beyond specified address range 

Cause: Memory disassembly is attempted on an address range that is too small. 

Action: Display memory mnemonic using a large address range, or no address 
range at all. 

Perfinit - Absolute file (database) must be loaded line <LINE NUMBER> 

Cause: No symbolic data base has been opened (or exists) for the target file when 
you executed the "performance_measurement_initialize" command. 

Action: Make sure a data base has been loaded for the target file. 

Perfinit - error in input file line <LINE NUMBER> invalid symbol 

You included a "label" file name with your "performance_measurement_initialize" 
command, and that file contains an invalid symbol. 

Action: Edit the file and correct the invalid symbol. 
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Perfinit - error in input file line <NUMBER> 

Cause: You included an input file name with your 

"performance_measurement_initialize" command, and that file contains a syntax 
error. 

Action: Edit the file and correct the syntax error. 

Perfinit < — EXPR — ERROR> line <LINE NUMBER> 

Perfinit - File could not be opened 

Cause: You specified a file as an option to "performance_measurement_initialize", 
and the file you specified could not be found or opened by SPMT software. 

Action: Make sure you entered the correct file name. 
Perfinit - No events in file 

Cause: You specified a file along with your "performance_measurement"initialize" 
command that contained no events. Any measurement displayed from this file will 
have NULL results. 

Action: Either edit the file to add events, or use the default setup to start a new 
measurement. 

perf.out file could not be opened - created 

Cause: The performance analyzer failed to open or create a file named "perf.out" in 
response to your "performance_measurement_end" command. 

Action: Free up some file space or correct the write permissions in your current 
working directory. 

Performance tool must be initialized 

Cause: You tried to make a performance measurement when the Software 
Performance Measurement Tool (SPMT) was not initialized. 

Action: The Software Performance Measurement Tool (SPMT) must be initialized 
before making performance measurements on your software. Use the 
performance_measurement_initialize command to initialize the SPMT. 
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Performance tool not initialized 

Cause: The Software Performance Measurement Tool (SPMT) has not been 
initialized. 

Action: To make accurate activity or duration measurements on current data, use 
the performance_measurement_initialize command to initialize the SPMT before 
running a performance measurement. 

Question file missing or invalid 

Cause: Some of the Softkey User Interface files are missing or are corrupted. 
Action: Reinstall the host software and try starting the emulation session again. 

Range crosses segment boundary 

Cause: On a segment offset processor, an address range is specified that would 
cross different segments. 

Action: Break the memory command into multiple commands so that the address 
ranges start and end in the same segment. 

Read memory failed at <PHYSICAL ADDRESS> - store aborted 

Cause: While storing memory from the emulator to a file, a read memory error 
occurred. 

Action: Use the display errorjog command to view any errors. You may need to 
modify the configuration and map memory before storing the file again. 

Session aborted 

Cause: This will only happen when running multiple emulation windows and a 
fatal system error occurs. 

Action: Find the window that caused the error and see the error message that it 
displayed. All the additional windows will simply state "session aborted". Cycle 
power on the emulator and enter emul700 -u <logical name> to make sure the 
emulator is unlocked. 
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Session cannot be continued, ending released 

Cause: The emulation session is ending automatically because it could not be 
continued from the previous session. When the session has ended the emulator will 
be released, meaning that others can access and use it. 

Action: When you restart the emulation session later, the new session will use all 
default settings. 

Slave clock requires at least one edge 

Cause: The analyzer has an invalid clock specification. 

Action: Modify your configuration and try your command again. 

Starting address greater than ending address 

Cause: You specified a starting address that is greater than the ending address. 
Action: Specify a starting address that is less than or equal to the ending address. 

Starting new session, continue file loaded 

Cause: This is a status message. The emulator was started using a new emulation 
session, and the continue file loaded properly. 

Starting new session, user interface defaulted 

Cause: The emulator was started using a new emulation session, and the user 
interface was set to default selections. 

Action: Call your HP Service Representative. 

Status unknown, run "emul700 -1 <LOGICAL NAME>" 

Cause: The host system cannot determine the status of the emulator. 

Action: To verify communication between the emulator and the host system, and 
display the emulator status, enter the emul700 -1 <logical name> command. The 
emulator logical name is located in the $HP64000/etc/64700tab.net (or 64700tab) 
file. 
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Stepping aborted; number steps completed: <STEPS TAKEN> 

Cause: Stepping aborted because <CTRL>c or software breakpoint was hit, 
guarded memory was accessed, or some other kind of error occurred. 

Action: See the error log display for any abnormal errors. Correct those errors and 
then step again. 

Stepping complete 

Cause: Stepping was completed successfully. 

Step count must be 1 through 999 

Cause: You tried to use a step count greater than 999. 
Action: Use a step count less than 1000. 

Symbols not accessible, symbol database not loaded 

Cause: You specified a trace list with values expressed using symbols defined in 
the source code modules, such as source on, and the database file has not been 
loaded into emulation. Example: display trace symbols on. 

Timeout in emul700dmn communication 

Cause: The host system could not start the emulation session because the HP 64700 
emulator process ran out of time before the emulator could start. 

Action: You must press end_release_system to exit this emulation session 
completely; then start a new session. Make sure the host system is operating 
properly, that all Softkey Interface software has been loaded correctly, and the data 
communication switch settings on the emulator rear panel match the settings in the 
$HP64000/etc/64700tab.net (or 64700tab) file. 

Trace file not found 

Cause: You tried to load trace data file that does not exist. 

Action: Find the correct name and path of the trace data file and try again. 
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Unexpected message from emul700dmn 

Cause: The host system could not start the emulation session because of an 
unexpected message from the HP 64700 emulator process command. 

Action: You must press end_release_system to exit this emulation session 
completely; then start a new session. Make sure the host system is operating 
properly, that all Softkey Interface software has been loaded correctly, and the data 
communication switch settings on the emulator rear panel match the settings in the 
$HP64000/etc/64700tab.net (or 64700tab) file. 

Unknown expression type 

Cause: While entering your command, you included an unknown expression type. 

Action: See the EXPR command syntax for more information about expressions. 
Then try entering your command again with a known expression type. 

Unload trace data failed 

Cause: An unexpected error occurred while waiting for a trace to be completed. 
Action: End and release the session, and then try again. 

Wait time failure, could not determine system time 

Cause: The system call failed. 

Action: Verify that 'date' executes correctly from the UNIX prompt. 

Warning: at least one integer truncated to 32 bits 
Warning: at least one integer truncated to 16 bits 
Warning: at least one integer truncated to 8 bits 

Cause: The number entered was too large for the currently specified display or 
access size. 

Action: Try entering the command again using the correct size of number. 
Width not in range: 1 <= valid width <= 80 

Cause: You tried to specify the width of the field outside the range from 1 to 80. 
Action: Try entering the command again using a valid number for the width. 
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These numbered messages can occur because of various problems with the 
emulator/analyzer. 

1 031 5 Logical emulator name unknown; not found in 64700tab file 

Cause: This message may occur while trying to start up the emulator. It indicates 
that the emulator name specified could not be found in the 64700tab.net or 
/etc/hosts files. 

Action: Specify the name in one of these files. 

1 0326 Emulator locked by another user 

Cause: This message occurs when you try to start an emulation interface, but your 
attempt failed because the emulator is being used by someone else. 

Action: The current user must release the emulator. 

1 0327 Cannot lock emulator; failure in obtaining the accessid 
Cannot lock emulator; failure in <ERRNO MSG> 

1 0328 Cannot unlock emulator; emulator not locked 

Cause: You have issued a command to unlock an emulator that is not locked. 
Action: The emulator is available now. You can start the interface. 

1 0328 Cannot unlock emulator; lock file missing 

1 0328 Cannot unlock emulator; semaphore missing 

Cause: Lock semaphore missing. 

Action: Verify existence and permissions of $HP64000 directory. Cycle emulator 
power and use emul700 -u <logical name>. 

1 0328 Cannot unlock emulator; emulator in use by user: <USER NAME> 

Cause: The emulator is already in use by the named user. 
Action: Current user must release the emulator. 
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1 0329 Emulator locked by user: <USER NAME> 



Cause: You tried to start an emulator interface, but your attempt failed because the 
emulator is already in use by someone else. 

Action: Current user must release the emulator. 



1 0330 Emulator locked by another user interface 

Cause: You tried to start an emulator interface, but your attempt failed because the 
emulator is already in use by someone else. 

Action: Current user must release the emulator. 

1 033 1 HP64700 I/O channel in use by emulator: <LOGICAL NAME> 

Cause: You tried to start an emulator interface, but your attempt failed because the 
emulator is already in use by someone else. 

Action: Current user must release the emulator. 

1 0332 Cannot default emulator; already in use 

Cause: You tried to start an emulator interface, but your attempt failed because the 
emulator is already in use by someone else. 

Action: Current user must release the emulator. 

1 0350 Cannot interpret emulator output 

Cause: There may be characters dropped in the information returned from the 
emulator. 

Action: Ignore this message unless it becomes frequent. If it becomes frequent, you 
may have a fatal error; call your HP 64700 representative. 

1 0351 Exceeded maximum 64700 command line length 

Cause: Your command is longer than 240 characters. 
Action: Shorten the command. 

1 0352 Incompatible with 64700 firmware version 

Cause: The installed interface firmware combination is incorrect or incompatible. 
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Action: Upgrade the interface software of product firmware. 

1 0360 Analyzer limitation; all range resources in use 

Analyzer limitation; all pattern resources in use 
Analyzer limitation; all expression resources in use 

Cause: Your trace specification would use more than the maximum number of 
resources available to the analyzer. 

Action: Simplify the trace specification. 

1 0371 64700 command aborted 

Cause: User abort occurred due to emulator being monopolized by another 
command. 

Action Don't issue an abort. 
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Terminal Interface Messages 

This section contains descriptions of error messages that can occur while using the 
Terminal Interface. The error messages are listed in numerical order, and each 
description includes the cause of the error and the action you should take to remedy 
the situation. 

The emulator can return messages to the display only when it is prompted to do so. 
Situations may occur where an error is generated as the result of some command, 
but the error message is not displayed until the next command (or a carriage return) 
is entered. 

A maximum number of 8 error messages can be displayed at one time. If more 
than 8 errors are generated, only the last 8 are displayed. 

Emulator Messages 

20 Attempt to change foreground monitor map term 

Cause: When configuring the emulator to use a foreground monitor, a memory 
range is automatically mapped for the monitor's use. You attempted to alter that 
term when mapping memory. 

Action: Try using another memory range for the new map term. If you need to 
have the range used by the foreground monitor, then switch to a background 
monitor, delete the old foreground monitor map term, and add the new term. Now 
you can return to using a foreground monitor; remember you will need to reload the 
monitor code. 

21 Insufficient emulation memory 

Cause: You have attempted to map more emulation memory than is available. 
Action: Reduce the amount of emulation memory that you are trying to map. 

40 Restricted to real time runs 

Cause: While the emulator is restricted to real-time execution, you have attempted 
to use a command that requires a temporary break in execution to the monitor. The 
emulator does not permit the command and issues this error message. 
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Action: You must break the emulator's execution into the monitor before you can 
enter the command. 

61 Emulator is in the reset state 

Cause: You have entered a command that requires the emulator to be running in 
the monitor (for example, displaying registers). 

Action: Enter the break command to cause the emulator to run in the monitor, and 
enter the command that caused the error again. 

80 Stack pointer is odd 

Cause: You have attempted to modify the stack pointer to an odd value for a 
processor that expects the stack to be aligned on a word boundary (such as the 
68302). 

Action: Modify the stack pointer to an even value. 

81 Stack is in guarded memory 

Cause: Your stack pointer pointed to a location in memory mapped as guarded; 
you then attempted to run or step the emulation processor. The emulator was 
unable to access the stack to complete the transition from the monitor to the user 
program or vice versa. 

Action: Either remap memory so the stack pointer points to a location in RAM, or 
change the stack pointer value (either with your program or by configuring the 
emulator's stack pointer value on reset) to point to a location in RAM. 

82 Stack is in target ROM 

Cause: Your stack pointer pointed to a location in memory mapped as target ROM; 
you then attempted to run or step the emulation processor. The emulator was 
unable to access the stack to complete the transition from the monitor to the user 
program or vice versa. 

Action: Either remap memory so the stack pointer points to a location in RAM, or 
change the stack pointer value (either with your program or by configuring the 
emulator's stack pointer value on reset) to point to a location in RAM. 
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83 Stack is in emulation ROM 



Cause: Your stack pointer pointed to a location in memory mapped as emulation 
ROM; you then attempted to run or step the emulation processor. The emulator 
was unable to access the stack to complete the transition from the monitor to the 
user program or vice versa. 

Action: Either remap memory so the stack pointer points to a location in RAM, or 
change the stack pointer value (either with your program or by configuring the 
emulator's stack pointer value on reset) to point to a location in RAM. 



84 Program counter is odd 



Cause: You attempted to modify the program counter to an odd value using the 
modify registers command on a processor which expects even alignment of 
opcodes. 

Action: Modify the program counter only to even numbered values. 



1 02 Monitor failure; no clock input 



Cause: The monitor is unable to run because no emulation processor clock is 
available. 

Action: Make sure a clock meeting the microprocessor's specifications is input to 
the clock pin of the target system probe. 



1 03 Monitor failure; no processor cycles 



Cause: The monitor is unable to run since the processor is not running. The 
monitor is unable to determine the cause of the failure. 

Action: If running in-circuit, troubleshoot the target system. If running out of 
circuit, reinitialize the emulator and try the procedure again. 



1 04 Monitor failure; bus grant 



Cause: The monitor is unable to run. The emulation processor is not running 
because it has granted the bus to another device. 

Action: Wait until the processor has regained bus control, then retry the operation. 
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1 05 Monitor failure; halted 

Cause: The monitor is unable to run because the processor is halted (due to an 
external halt line or a halt instruction). 

Action: Release the external halt and retry the operation. If the processor halted 
due to a halt instruction, try the reset command, then retry the operation. 

1 06 Monitor failure; wait state 

Cause: The monitor is unable to run because the processor is in a continuous wait 
state. 

Action: A continuous wait state may indicate target system problems. 
Troubleshoot the wait line. If you were running out of circuit, try initializing the 
emulator, then retry the procedure. 

1 07 Monitor failure; bus error 

Cause: The monitor is unable to run because the processor has encountered a bus 
fault (such as the 68302 /BERR line). 

Action: Release the /BERR line and determine why it was activated. 

68302 Emulator Messages 

The following error messages are unique to the 68302 emulator. 

1 40 Supervisor stack pointer not initialized 

Cause: The supervisor stack pointer was not initialized to a value on the transition 
from emulation reset to the monitor. 

Action: Modify the emulator configuration to define a supervisor stack pointer 
lying within an area mapped as RAM and reserved for stack space, and make the 
transition from emulator reset to the monitor. Or, you can modify the supervisor 
stack pointer directly by modifying the SSP register. 

141 Foreground monitor operating in USER mode 

Cause: The foreground monitor was found operating in the 68302 user program 
state. 
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Action: Reset the emulator. Check your foreground monitor source code to verify 
that it keeps the processor in the supervisor state and does not make transitions into 
the user program state. 



1 42 Supervisor stack in guarded memory at <address> 

Cause: The supervisor stack either was defined in or grew into a memory range 
mapped as guarded. 

Action: Reset the emulator. Then, define the supervisor stack pointer within a 
memory range mapped as emulation or target RAM and allow sufficient room for 
the stack to grow as procedures are activated and deactivated. 

1 43 Supervisor stack is in ROM at <address> 

Cause: The supervisor stack either was defined in or grew into a memory range 
mapped as ROM. 

Action: Reset the emulator. Then, define the supervisor stack pointer within a 
memory range mapped as emulation or target RAM and allow sufficient room for 
the stack to grow as procedures are activated and deactivated. 

1 45 BERR occurred during background operation 

Cause: A bus error was encountered while the emulator was executing the 
background monitor. 

Action: Reset the emulator. 

1 46 BERR during background access to supervisor stack 

Cause: A bus error occurred while the emulation monitor was attempting to push 
or pop data on the supervisor stack. 

Action: Define the supervisor stack pointer within a memory range mapped as 
emulation or target RAM and allow sufficient room for the stack to grow as 
procedures are activated and deactivated. 

1 47 RESET during background operation 

Cause: A target system RESET occurred while the emulator was executing in the 
background monitor. 
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Action: Verify the register state is as expected, if so, you may continue with no 
further action. If not, reset the emulator from the emulation system. 

1 48 cf int7 must be lev if cf im=nor 

Cause: The target system interrupt mode is set to normal, so there is no such thing 
as IRQ7. 

Action: Either make interrupt 7 level sensitive or configure the emulator for the 
dedicated interrupt mode. 

1 49 Register modify would cause chip select address decode conflict 

Cause: The chip select register modification you just attempted would cause two or 
more chip selects to be enabled and overlap. 

1 50 bar register must not map internal memory to 0 

Cause: If internal memory were mapped to 0, the vector table along with the BAR 
and SCR registers would be overwritten. 

1 51 HP 64170A has missing memory module: 
bank <bank number> 

Action: Make sure the HP 64170 memory board has at least one memory module 
installed in bank 0. It is not required for bank 1 to have a memory module. This 
must be corrected for the emulator to function correctly. 

An example showing an empty bank (bank 1), viewed with the Terminal Interface 
ver command, is: 



HP 64746 (PPN: 64746A) Motorola 68302 Emulator 

Version: A. 00. 03 24Jun91 

Control: HP64170A Memory Control Board 

Memory: 0 KBytes 

Bank 0: HP64171A/C 256 KByte Memory Module 

Bank 1 : Empty 

Bank 2 : Empty 

Bank 3: Empty 



1 52 HP 64170A has mixed memory modules: 

banks 0, <bank number> 

Cause: The memory modules loaded on the memory board can be 256 Kbyte 
modules or 1 Mbyte modules, but not a combination of both types. Mixing the two 
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types of memory modules is not allowed. This must be corrected for the emulator 
to function correctly. 

An example showing an invalid mixing of modules, viewed with the Terminal 
Interface ver command, is: 



HP 64746 (PPN: 64746A) Motorola 68302 Emulator 
Version: A. 00. 03 24Jun91 

Control: HP64170A Memory Control Board 



Memory 




0 KBytes 




Bank 


0 : 


HP64171A/C 


256 KByte Memory Module 


Bank 


1 : 


HP64171B/D 


1024 KByte Memory Module 


Bank 


2 : 


Empty 




Bank 


3: 


Empty 





1 53 HP 64170A has unrecognized memory module: 

bank <bank number> 

Cause: The HP 64170 memory board has detected an unusable memory module. 

Action: Verify that a memory module is installed in the bank in question. If the 
correct memory module is installed, or if there is no memory module installed, a 
hardware fault may be present. This must be corrected for the emulator to function 
properly. 

An example showing an unrecognized memory module, viewed with the Terminal 
Interface ver command, is: 



HP 64746 (PPN: 64746A) Motorola 68302 Emulator 
Version: A. 00. 03 24Jun91 

Control: HP64170A Memory Control Board 



Memory 




0 KBytes 


Bank 


0: 


HP64171A/C 256 KByte Memory 


Bank 


1 : 


Unrecognized Memory Module 


Bank 


2 : 


Empty 


Bank 


3: 


Empty 



1 54 Unable to find emulation memory 

Cause: The emulator cannot determine which emulation memory board is installed. 

Action: This is a hardware fault, and must be corrected for the emulator to function 
correctly. Contact your HP Representative. 
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General Emulator and System Messages 

204 FATAL SYSTEM SOFTWARE ERROR 

205 FATAL SYSTEM SOFTWARE ERROR 

208 FATAL SYSTEM SOFTWARE ERROR 

Cause: The system has encountered an error from which it cannot recover. 

Action: Write down the sequence of commands which caused the error. Cycle 
power on the emulator and reenter the commands. If the error repeats, call your 
local HP Sales and Service office for assistance. 

206 Incompatible compatibility table entry 

Cause: The emulation firmware (ROM) is not compatible with the analysis or 
system firmware in your HP 64700 system. 

Action: The ROMs in your emulator must be compatible with each other for your 
emulation system to work correctly. Contact your Hewlett-Packard Representative. 

312 Ambiguous address: %s 

Cause: Certain emulators support segmentation or function code information in 
addressing. The emulator is unable to determine which of two or more address 
ranges you are referring to, based upon the information you entered. 

Action: Re-enter the command and fully specify the address, including 
segmentation or function code information. 

318 Count out of bounds: %s 

Cause: You specified an occurrence count less than 1 or greater than 65535. 
Action: Re-enter the command, specifying a count value from 1 to 65535. 

400 Record checksum failure 

Cause: During a transfer operation, the checksum specified in a file did not agree 
with that calculated by the HP 64700. 
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Action: Retry the transfer operation. If the failure is repeated, make sure that both 
your host and the HP 64700 data communications parameters are configured 
correctly. 



401 Records expected: %s; records received: %s 

Cause: The HP 64700 received a different number of records than it expected to 
receive during a transfer operation. 

Action: Retry the transfer. If the failure is repeated, make sure that the data 
communications parameters are set correctly on the host and on the HP 64700. 

410 File transfer aborted 

Cause: A transfer operation was aborted due to a break received, most likely a 
<CTRL>c from the keyboard. 

Action: If you typed <CTRL>c, you probably did so because you thought the 
transfer was about to fail. Retry the transfer, making sure to use the correct 
command options. If you are unsuccessful, make sure that the data 
communications parameters are set correctly on the host and on the HP 64700, then 
retry the operation. 

41 1 Severe error detected, file transfer failed 

Cause: An unrecoverable error occurred during a transfer operation. 

Action: Retry the transfer. If it fails again, make sure that the data 
communications parameters are set correctly on the host and on the HP 64700. 
Also make sure that you are using the correct command options, both on the 
HP 64700 and on the host. 

41 2 Retry limit exceeded, transfer failed 

Cause: The limit for repeated attempts to send a record during a transfer operation 
was exceeded, therefore the transfer was aborted. 

Action: Retry the transfer. Make sure you are using the correct command options 
for both the host and the HP 64700. The data communications parameters need to 
be set correctly for both devices. Also, if you are in a remote location from the 
host, it is possible that line noise may cause the failure. 
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41 3 Transfer failed to start 

Cause: Communication link or transfer protocol incorrect. 
Action: Check link and transfer options. 

41 5 Timeout, receiver failed to respond 

Cause: Communication link or transfer protocol incorrect. 
Action: Check link and transfer options. 

600 Adjust PC failed during break 

Cause: System failure or target condition. 

Action: Run performance verification (Terminal Interface pv command), and 
check target system. 

602 Break failed 

Cause: The break command was unable to break the emulator to the monitor. 

Action: Determine why the break failed, then correct the condition and retry the 
command. See message 608. 

603 Read PC failed during break 

Cause: System failure or target condition. 
Action: Try again. 

604 Disable breakpoint failed: %s 

Cause: System failure or target condition. 

Action: Run performance verification (Terminal Interface pv command), and 
check target system. 

605 Undefined software breakpoint: %s 

Cause: The emulator has encountered a software breakpoint in your program that 
was not inserted with the modify softwarejbreakpoints set command. 

Action: Remove the breakpoint instructions in your code before assembly and link. 
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606 Unable to run after CMB break 

Cause: System failure or target condition. 



Action: Run performance verification (Terminal Interface pv command), and 
check target system. 



608 Unable to break 



Cause: This message is displayed if the emulator is unable to break to the monitor 
because the emulation processor is reset, halted, or is otherwise disabled. 

Action: First, look at the emulation prompt and other status messages displayed to 
determine why the processor is stopped. If reset by the emulation controller, use 
the break command to break to the monitor. If reset by the emulation system, 
release that reset. If halted, try reset and break to get to the monitor. If there is a 
bus grant, wait for the requesting device to release the bus before retrying the 
command. If there is no clock input, perhaps your target system is faulty. It's also 
possible that you have configured the emulator to restrict to real time runs, which 
will prohibit temporary breaks to the monitor. 



610 Unable to run 

Cause: System failure or target condition. 



Action: Run performance verification (Terminal Interface pv command), and 
check target system. 



61 1 Break caused by CMB not ready 



Cause: This status message is printed during coordinated measurements if the 
CMB READY line goes false. The emulator breaks to the monitor. When CMB 
READY is false, it indicates that one or more of the instruments participating in the 
measurement is running in the monitor. 

Action: None, information only. 



61 2 Write to ROM break 



Cause: This status message will be printed if you have enabled breaks on writes to 
ROM and the emulation processor attempted a write to a memory location mapped 
as ROM. 

Action: None (except troubleshooting your program). 
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61 3 Analyzer Break 

Cause: Status message. 

61 4 Guarded memory access break 

Cause: This message is displayed if the emulation processor attempts to read or 
write memory mapped as guarded. 

Action: Troubleshoot your program; or, you may have mapped memory incorrectly. 

61 5 Software breakpoint: %s 

Cause: This status message will be displayed if a software breakpoint is 
encountered during a program run. The emulator is broken to the monitor. The 
string %s indicates the address where the breakpoint was encountered. 

61 6 BNC trigger break 

Cause: This status message will be displayed if you have configured the emulator 
to break on a BNC trigger signal and the BNC trigger line is activated during a 
program run. The emulator is broken to the monitor. 

61 7 CMB trigger break 

Cause: This status message will be displayed if you have configured the emulator 
to break on a CMB trigger signal and the CMB trigger line is activated during a 
program run. The emulator is broken to the monitor. 

61 8 trigl break 

Cause: This status message will be displayed if you use the break_on_trigger 
syntax of the trace command and the analyzer has found the trigger condition while 
tracing a program run. The emulator is broken to the monitor. 

61 9 trig2 break 

Cause: This status message will be displayed if you have used the internal trig2 
line to connect the analyzer or external analyzer trigger output to the emulator 
break input and the analyzer has found the trigger condition. The emulator is 
broken to the monitor. 
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620 Unexpected software breakpoint 

Cause: If you have enabled software breakpoints, this message is displayed if a 
software breakpoint instruction is encountered in your program that was not 
inserted by a modify softwarejbreakpoints set command and is therefore not in 
the breakpoint table. 

Action: Remove the breakpoint instructions in your code before assembly and link, 
and use the modify softwarejbreakpoints set command to reinsert them after the 
program is loaded into memory. 

621 Unexpected step break 

Cause: System failure. 

Action: Run performance verification (Terminal Interface pv command). 

622 %s 

Cause: Monitor specific message. 

623 CMB execute break 

Cause: This message occurs when coordinated measurements are enabled and an 
EXECUTE pulse causes the emulator to run; the emulator must break before 
running. 

Action: This is a status message; no action is required. 

624 Configuration aborted 

Cause: Occurs when a <CTRL>c is entered while emulator configuration items are 
being set. 

626 Configuration failed; setting unknown: %s=%s 

Cause: Target condition or system failure. 

Action: Check target system, and run performance verification (Terminal Interface 
pv command). 
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628 Guarded memory break: %s" 

Cause: A memory access to a location mapped as guarded memory has occurred 
during execution of the user program. 

Action: Investigate the cause of the guarded memory access by the user program. 

628 Write to ROM break: %s" 

Cause: When the emulator is configured to break on writes to ROM, a memory 
write access to a location mapped as ROM has occurred during execution of the 
user program. 

Action: Investigate the cause of the write to ROM by the user program. You can 
configure the emulator so that it does not break on writes to ROM. 

630 Register access aborted 

Cause: Occurs when a <CTRL>c is entered during register display. 

631 Unable to read registers in class: %s 

Cause: The emulator was unable to read the registers you requested. 

Action: To resolve this, you must look at the other status messages displayed. 
Most likely, the emulator was unable to break to the monitor to perform the register 
read. See message 608. 

632 Unable to modify register: %s=%s 

Cause: The emulator was unable to modify the register you requested. 

Action: To resolve this, you must look at the other status messages displayed. It's 
likely that emulator was unable to break to the monitor to perform the register 
modification. See message 608. 

634 Display register failed: %s 

Cause: The emulator was unable to display the register you requested. 

Action: To resolve this, you must look at the other status messages displayed. It's 
likely that emulator was unable to break to the monitor to perform the register 
display. See message 608. 
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636 Register not writable: %s 

Cause: This error occurs when you attempt to modify a read only register. 

Action: If this error occurs, you cannot modify the contents of the register with the 
modify register command. 

637 Register class cannot be modified: %s 

Cause: You tried to modify a register class instead of an individual register. 

Action: You can only modify individual registers. Refer to the display registers 
command description for a list of register names. 

640 Unable to reset 

Cause: Target condition or system failure. 

Action: Check target system, and run performance verification (Terminal Interface 
pv command). 

650 Unable to configure break on write to ROM 

Cause: The emulator controller is unable to configure for breaks on writes to 
ROM, possibly because the emulator was left in an unknown state or because of a 
hardware failure. 

Action: Initialize the emulator or cycle power. Then reenter the command. If the 
same failure occurs, call your HP sales and service office. 

651 Unable to configure break on software breakpoints 

Cause: The emulator controller cannot enable breakpoints, possibly because the 
emulator is in an unknown state or because of a hardware failure. 

Action: Initialize the emulator or cycle power, then re-enter the command. If the 
same failure occurs, call your HP sales and service office. 

653 Break condition configuration aborted 

Cause: Occurs when <CTRL>c is entered during the configuration of break 
conditions. 
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661 Software breakpoint break condition is disabled 

Cause: You have attempted to set or clear a software breakpoint when software 
breakpoints are disabled. 

Action: You must enable software breakpoints before you can set them. 

663 Specified breakpoint not in list: %s 

Cause: You tried to clear a software breakpoint that was not previously set. The 
string %s prints the address of the breakpoint you attempted to clear. 

Action: You must first set a software breakpoint before it can be cleared. 

664 Breakpoint list full; not added: %s 

Cause: The software breakpoint table is already reached the maximum of 32 
breakpoints. The breakpoint you just requested, with address %s, was not inserted. 

Action: Clear breakpoints that are no longer in use. Then, set the new breakpoint. 

665 Enable breakpoint failed: %s 

Cause: System failure or target condition. 

Action: Check memory mapping and configuration questions. 

666 Disable breakpoint failed: %s 

Cause: System failure or target condition. 

Action: Check memory mapping and configuration questions. 

667 Breakpoint code already exists: %s 

Cause: You attempted to insert a breakpoint; however, there was already a 
software breakpoint instruction at that location which was not already in the 
breakpoint table. 

Action: Your program code is apparendy using the same instructions as used by 
the software breakpoints feature. Remove the breakpoint instructions from your 
program code and use the modify softwarejbreakpoints set command to insert 
them. 
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668 Breakpoint not added: %s 



Cause: You tried to insert a breakpoint in a memory location which was not 
mapped or was mapped as guarded memory. 

Action: Insert breakpoints only within memory ranges mapped to emulation or 
target RAM or ROM. 

669 Breakpoint remove aborted 

Cause: Occurs when <CTRL>c is entered when clearing a software breakpoint. 

670 Breakpoint enable aborted 

Cause: Occurs when <CTRL>c is entered when setting software breakpoints. 

671 Breakpoint disable aborted 

Cause: Occurs when <CTRL>c is entered when disabling software breakpoints. 

680 Stepping failed 

Cause: Stepping has failed for some reason. 

Action: Usually, this error message will occur with other error messages. Refer to 
the descriptions of the accompanying error messages to find out more about why 
stepping failed. 

684 Failed to disable step mode 

Cause: System failure. 

Action: Run performance verification (Terminal Interface pv command). 

686 Stepping aborted; number steps completed: %d 

Cause: This message is displayed if a break was received during a step command 
with a step count greater than zero. The break could have been due to any of the 
break conditions or a <CTRL>c break. The number of steps completed is displayed. 

688 Step display failed 

Cause: System failure or target condition. 
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Action: Check memory mapping and configuration questions. 



689 Break due to cause other than step 



Cause: An activity other than a step command caused the emulator to break. This 
could include any of the break conditions or a <CTRL>c break. 



692 Trace error during CMB execute 

Cause: System failure. 

Action: Run performance verification (Terminal Interface pv command). 



693 CMB execute; run started 

Cause: This status message is displayed when you are making coordinated 
measurements. The CMB /EXECUTE pulse has been received; the emulation 
processor started running at the address specified by the specify run command. 

Action: None; information only. 



694 Run failed during CMB execute 

Cause: System failure or target condition. 

Action: Run performance verification (Terminal Interface pv command), and 
check target system. 



700 Target memory access failed 

Cause: This message is displayed if the emulator was unable to perform the 
requested operation on memory mapped to the target system. 

Action: In most cases, the problem results from the emulator's inability to break to 
the monitor to perform the operation. See message 608. 

702 Emulation memory access failed 

Cause: System failure. 

Action: Run performance verification (Terminal Interface pv command). 
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707 Request access to guarded memory: %s 

Cause: The address or address range specified in the command included addresses 
within a range mapped as guarded memory. When the emulator attempts to access 
these during command processing, the above message is printed, along with the 
specific address or addresses accessed. 

Action: Re-enter the command and specify only addresses or address ranges within 
emulation or target RAM or ROM. Or, you can remap memory so that the desired 
addresses are no longer mapped as guarded. 

71 0 Memory range overflow 

Cause: Accessing a word or short word, for example display memory OfffffflT 
blocked word will cause a rounding error that overflows physical memory. 

Action: Reduce memory display request. 

725 Unable to load new memory map; old map reloaded 

Cause: There is not enough emulation memory left for this request. 
Action: Reduce the amount of emulation memory requested. 

726 Unable to reload old memory map; hardware state unknown 

Cause: System failure. 

Action: Run performance verification (Terminal Interface pv command). 

754 Memory modify aborted; next address: %s 

Cause: This message is displayed if a break occurs during processing of a modify 
memory command. The break could result from any of the break conditions 
(except a software breakpoint) or could have resulted from a <CTRL>c break. 

Action: Retry the operation. If breaks are occurring continuously, you may wish to 
disable some of the break conditions. 

901 Invalid firmware for emulation subsystem 

Cause: This error occurs when the HP 64700 system controller determines that the 
emulation firmware (ROM) is invalid. 
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Action: This message is not likely to occur unless you have upgraded the ROMs in 
your emulator. Be sure that the correct ROM is installed in the emulation controller. 

902 Invalid analysis subsystem; product address: %s 

Cause: This error occurs when the HP 64700 system controller determines that the 
analysis firmware (ROM) is invalid. 

Action: This message is not likely to occur unless you have upgraded the ROMs in 
your emulator. Be sure that the correct ROMs are installed in the analyzer board. 

903 Invalid ET subsystem; product address: %s 

Cause: Detects an invalid ET. Used only internally. 

904 Invalid auxiliary subsystem; product address: %s 

Cause: For future products. 

911 Lab firmware for emulation subsystem 

Cause: This message should never occur. It shows that you have an unreleased 
version of emulation firmware. 

912 Lab firmware analysis subsystem; product address: %s 

Cause: This message should never occur. It shows that you have an unreleased 
version of analysis firmware. 

913 Lab firmware subsystem; product address: %s 

Cause: This message should never occur. It shows that you have an unreleased 
version of system controller firmware. 

914 Lab firmware auxiliary subsystem; product address: %s 

Cause: This message should never occur. It shows that you have an unreleased 
firmware version of the auxiliary subsystem. 
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Analyzer Messages 



1 1 05 Unable to delete label; used by emulation analyzer: <label> 

Cause: This error occurs when you attempt to delete an emulation trace label 
which is currently being used as a qualifier in the emulation trace specification or is 
currently specified in the emulation trace format. 

Action: You stop the trace or must change the trace command before you can 
delete the label. 

1 1 06 Unable to delete label; used by external state analyzer: <label> 

Cause: This error occurs when you attempt to delete an external trace label which 
is currently being used as a qualifier in the external state trace specification or is 
currently specified in the external trace format. 

Action: You stop the trace or must change the trace command before you can 
delete the label. 

1 1 07 Unable to delete label; used by external timing analyzer: <label> 

Cause: This error occurs when you attempt to delete an external trace label which 
is currently being used as a qualifier in the external timing trace specification. 

Action: Remove the label from the external timing analyzer specifications, and 
then delete the label. 

1 1 08 Unable to redefine label; used by emulation analyzer: <label> 

Cause: This error occurs when you attempt to redefine an emulation trace label 
which is currently used as a qualifier in the emulation trace specification. 

Action: You stop the trace or must change the trace command before you can 
redefine the label. 

1 1 09 Unable to redefine label; used by external state analyzer: <label> 

Cause: This error occurs when you attempt to redefine an external trace label 
which is currently used as a qualifier in the external state trace specification. 

Action: You stop the trace or must change the trace command before you can 
redefine the label. 
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1110 Unable to redefine label; used by external timing analyzer: <label> 

Cause: This error occurs when you attempt to redefine an emulation or external 
trace label which is currently being used as a qualifier in the external timing trace 
specification. 

Action: Remove the label from the external timing analyzer specifications, and 
then redefine the label. 

1 301 External label in use: <label> 

Cause: This error occurs when you attempt to select the external analyzer's 
independent state mode while an external trace label is currently used as a qualifier 
in the emulation analyzer trace specification. 

Action: Remove any external trace label qualifiers from emulation trace 
specifications before selecting the external analyzer's independent state mode. 

1 304 Analyzer trace running 

Cause: This error occurs when you attempt to change the external analyzer mode 
while a trace is in progress. 

Action: Halt the trace before changing the external analyzer mode. 

1 305 CMB execute; emulation trace started 

Cause: This status message informs you that an emulation trace measurement has 
started as a result of a CMB execute signal (as specified by the specify trace 
command). 

2021 Period not in 1/2/5 sequence: <period> 

Cause: This error message occurs when the external timing sample period is not in 
a 1/2/5 sequence; for example, 10ns, 20ns, 50ns, 100ns, 200ns, 500ns, lus, 2us, 
5us, etc. Some examples of invalid sample period specifications are: 12ns, 18ns, 
25ns, 60ns, 80ns, etc. 

Action: Use a number in the 1/2/5 sequence when specifying the external timing 
sample period. 
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2022 Sample period out of bounds: <bounds> 

Cause: The external timing sample period must be between 10 ns and 50 ms (in a 
1/2/5 sequence). 

Action: Re-enter the command with the sample period between the bounds shown. 

2030 Negated patterns not allowed in timing 

Cause: This error occurs when you attempt to specify a "not equals" expression 
when defining the external timing trigger. You can only specify labels which equal 
patterns (of l's, 0's, or X's). 

Action: Do not attempt to specify negated timing patterns. 

2031 Invalid trigger duration: <duration> 

Cause: This error occurs when you attempt to specify an external timing trigger 
duration which is in the valid range but is not a multiple of 10 ns. 

Action: Re-enter the command with the trigger duration as a multiple of 10 ns. 

2032 Trigger duration out of bounds: <bounds> 

Cause: This error occurs when you attempt to specify an external timing trigger 
duration outside the valid range. A "greater than" duration must fall within the 
range of 30 ns to 10 ms (and must be a multiple of 10 ns). A "less than" duration 
must fall within the range 40 ns to 10ms (and must be a multiple of 10 ns). 

Action: Re-enter the command with the trigger duration within the bounds shown. 

2042 Trigger delay out of bounds: <bounds> 

Cause: This error occurs when you attempt to specify an external timing trigger 
delay outside the valid range. The external timing trigger delay must be between 0 
and 10 ms (in 10 ns increments). 

Action: Re-enter the command with the trigger delay within the bounds shown. 
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Emulator Specifications and Characteristics 

This section contains the following types of emulator specifications and 
characteristics: 

• Processor compatibility. 

• Electrical characteristics (including emulator timing). 

• Physical characteristics. 

• Environmental characteristics. 

Processor Compatibility 

The HP 64746 is compatible with the Motorola 68302 microprocessor with clock 
speeds up to 20.0 MHz, and any other microprocessors that comply with the 
specifications of the Motorola 68302. The HP 64746 supports the MC68302 in 
either 8 or 16 bit mode. CPU disable mode is not supported. 

Electrical 

This section describes the electrical characteristics of the HP 64746 68302 
Emulator and the HP 64700 Card Cage. 

Electrical Characteristics of the HP 64746 Emulator 

The following specifications are for an emulator with a clock speed of 16.67 MHz. 

Maximum Clock Speed The maximum external clock speed is at least 20 MHz 
for the HP 64746 emulator. No wait states are required for emulation or target 
system memory. (The internal clock speed is 16 MHz.) 

Power The emulator draws an additional 40 milliamps from the target system 
when operating at 16.67 MHz. 

Unbuffered Signals The following signals are unbuffered to the target system: 
/RESET, /HALT, PB1-PB11, PA0-PA15, RXD1, TXD1, RCLK1, TCLK1, /CD1, 
/CTS1,/RTS1,BRG1,BCLR, /RMC, IAC. 

Data Inputs One 74FCT245A load per bit plus 50 pf capacitance. 
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Address and Function Codes One 74FCT245A load per bit plus 50 pf 
capacitance. 

Clocks One 74ACT load per bit plus 20 pf capacitance. 

Chip Selects One 74FCT244A load per bit plus 50 pf capacitance. 

Interrupts One F load per bit plus a 3.3K pullup and 50 pf capacitance. 

Other Signals /FRZ, /AVEC, BUSW are 74ALS inputs plus 50 pf capacitance. 

/DTACK, /BR, /BG, /BGACK have a 5 ns pal path to the processor. 

/UDS, /LDS, /AS, R/W have a 5 ns pal path to the processor plus a 3.3K pullup and 
50 pf capacitance. 

Bus Error is either connected to the target system unbuffered or totally 
disconnected from the target. 

The emulator specifications for "worst case" and "typical" are a function of loading 
in the target system. Actual performance may be worse than "worst case" if the 
loading is above Motorola specifications for the processor. 
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Processor 


Emulator 
Worst Typical 


Num 


Description 


Unit 


Symbol 


IVI in 


Max 


Min 


Max 


Min 


Max 


1 


Clock Period 


MHz 


f 


8 


16.7 


8 


16.7 






2,3 


Clock Pulse Width 


ns 


Tcvc 


60 


125 


60 


125 


- 


- 


4,5 


Clock Rise and Fall times 


ns 


Tcr,Tcf 


- 


5 


- 


5 


- 


- 


5a 


EXTAL to CLKO Delay 


ns 


Ted 


2 


11 


16 


29 


18 


- 


6 


Clock High to FC, Addr valid 


ns 


Tchfcadv 


- 


45 


9 


59 


5 


40 


7 


Clock High to addr, data - Z 


ns 


Tchadz 


- 


50 


- 


- 


- 


- 


8 


Clock High to addr, fc invalid 


ns 


Tchafi 


0 


- 


0 


- 


0 


- 


9 


Clock High to AS, DS asserted 


ns 


Tchsl 


3 


30 


5 


50 


8 


23 


11 


Addr, FC valid to AS,DS (READ) 
AS (WRITE) asserted 


ns 


Tafcvsl 


15 


- 


13 


- 


20 


- 


12 


Clock low to AS,DS negated 


ns 


Tslsh 




30 




35 




20 


13 


AS,DS negated - Addr,FC invalid 


ns 


Tshafi 


15 




12 




20 




14 


AS,(DS read) width asserted 


ns 


Tsl 


120 




110 






120 


14A 


DS width asserted (write) 


ns 


Tdsl 


60 




50 




60 




15 


AS,DS width Negated 


ns 


Tsh 






JJ 








16 


Clock High to Control Bus Z 


ns 


Tchcz 




50 




50 




50 


17 


AS,DS negated to R/W invalid 


ns 


Tshrh 


15 




5 




10 




18 


Clock High to RW high 


ns 


Tchrh 




30 




40 




30 


20 


Clock High to RW low 


ns 


Tchrl 




30 




40 




30 


21 


Addr, FC valid to RW low 


ns 


Tafcvfl 


15 




10 




20 




22 


RW low to DS asserted write 


ns 


Trlsl 


30 




25 




32 




23 


Clock low to Data Out valid 


ns 


Tcldo 




30 




40 




35 
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Processor 


Emulator 
Worst Typical 


Num 


Description 


Unit 


Symbol 


IVI in 


Max 


Min 


Max 


Min 


Max 


25 


AS,DS negated to data invalid 


ns 


Tshdoi 


15 




10 




16 




26 


Data Out to DS asserted write 


ns 


Tdosl 


15 


- 


10 


- 


16 


- 


27 


Data Valid to Clock low (setup) 


ns 


Tdicl 


7 


- 


21 


- 


15 


- 


28 


AS,DS negated to DTACK negated 


ns 


Tshdah 


0 


110 


0 


90 


0 


100 


29 


AS,DS negated to Data in (hold) 


ns 


Tshdii 


0 


- 


0 


- 


0 


- 


30 


AS,DS negated to BERR negated 


ns 


Tshdeh 


0 


- 


0 


- 


0 


- 


31 


DTACK asserted to data in-setup 


ns 


Tdaldi 


- 


50 


43 




49 




32 


Halt, Reset input transition 


ns 


Trhr, 
Trhf 




150 




150 




<150 


33 


Clock High to BG asserted 


ns 


Tchgl 


- 


30 


- 


45 


- 


40 


34 


Clock High to BG negated 


ns 


Tchgh 


- 


30 


- 


60 


- 


40 


35 


BR asserted to BG asserted 


elks 


Tbrlgl 


2.5 


4.5 


2.5 


4.5 


2.5 


4.5 


36 


BR negated to BG negated 


elks 


Tbrhgh 


1.5 


2.5 


1.5 


2.5 


1.5 


2.5 


37 


BGACK asserted to BG negated 


elks 


Tgalgh 


2.5 


4.5 


2.5 


4.5 


2.5 


4.5 


37A 


BGACK asserted to BR negated 


ns/ 
elks 


Tgalbrh 


10 


1.5 


20 


1.5 


10 


1.5 


38 


BG asserted to high Z 


ns 


Tglz 




50 




50 




50 


39 


BG width negated 


elks 


Tgh 


1.5 




1.5 




1.5 




44 


AS,DS negated to AVEC negated 


ns 


Tshvph 


0 


50 


0 


30 


0 


40 


46 


BGACK width low 


elks 


Tgal 


1.5 




1.5 




1.5 




47 


Async input setup time 


ns 


Tasi 


10 




20 




15 




48 


BERR asserted to DTACK asserted 


ns 


Tbeldal 


10 




20 




15 
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Processor 


Emulator 
Worst Typical 


Num 


Description 


Unit 


Symbol 


IVI in 


Max 


Min 


Max 


Min 


Max 


53 


Data Out hold from clock high 


ns 


Tchdoi 


0 




0 




0 




55 


RW asserted to Data bus change 


ns 


Trldbd 


0 




0 




0 




56 


HALT,RST pulse width 


elks 


Thrpw 


10 




10 




10 




57 


BGACK negated to AS,DS,RW drive 


elks 


Tgasd 


1.5 




1.5 




1.5 




57A 


BGACK negated to FC driven 


elks 


Tgafd 


i 
i 




i 
i 




i 
i 




58 


BR negated to AS,DS,RW driven 


elks 


Trhsd 


1.5 




1.5 




1.5 




58A 


BR negated to FC driven 


elks 


Trhfd 


1 




1 




1 




60 


Clock high to BCLR asserted 


ns 


Tchbcl 




30 




45 




35 


61 


Clock high to BLCR negated 


ns 


Tchbch 




30 




45 




35 


62 


Clock low to RMC asserted 


ns 


Tclrml 




30 




45 




35 


63 


Clock high to RMC negated 


ns 


Tchrmh 




30 




45 




35 


64 


RMC negated to BG asserted 


ns 


Trmhgl 




30 




45 




35 



"High Z" or "Z" means high impedance. 
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Electrical Characteristics of the HP 64700 

The electrical characteristics of the HP 64700 communication ports are as follows. 
Communications 

Serial Port RS-232-C DCE or DTE to 38.4 Kbaud. 

RS-422 DCE to 460.8 Kbaud. 

BNC (labeled Input. The signal must drive approximately 4 mA at 2 V. Edge 
TRIGGER IN/OUlSensitive. Minimum pulse width is approximately 25 ns. 

Output. Driven active high only; 
equals +2.4V into a 50 ohm load. 

Physical 

Emulator Dimensions 

Width 325 mm (12.8 in.) 

Height 173 mm (6.8 in.) 

Length 389 mm (15.3 in.) 

Emulator Weight 

HP 64751 8.2 kg (18 lb) 

Cable Length 

Emulator to approximately 600 mm (2 ft), 

target system 

Communications 

Serial Port 25-pin female type "D" subminiature connector. 

CMB Port 9-pin female type "D" subminiature connector. 

CAUTION Possible damage to emulator. Any component used in suspending the emulator 

must be rated for 30 kg (65 lb) capacity. 
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Environmental 

Temperature 

Operating 0°C to +55°C 

(+32°F to 131 °F) 

Non-operating -40°C to +70°C 
(-40°Fto 158°F) 

Altitude 

Operating 4 600m 

(15 000 ft) 

Non-operating 15 300m 
(50 000 ft). 

Relative Humidity 

15% to 95%. 
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Concepts 



This chapter provides conceptual information on the following topics: 
• X resources and the Graphical User Interface. 
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X Resources and the Graphical User Interface 

This section contains more detailed information about X resources and scheme files 
that control the appearance and operation of the Graphical User Interface. This 
section: 

• Describes the X Window concepts surrounding resource specification. 

• Describes the Graphical User Interface' s implementation of scheme files. 

X Resource Specifications 

An X resource specification is a resource name and a value. The resource name 
identifies the element whose appearance or behavior is to be defined, and the value 
specifies how the element should look or behave. For example, consider the 
following resource specification: 

Application . form . row . done . background : red 

The resource name is "Application.form.row.done.background:" and the value is 
"red". 

Resource Names Follow Widget Hierarchy 

A widget is an OSF/Motif graphic device from which X applications are built. For 
example, pushbuttons and menu bars are Motif widgets. Applications are built 
using a hierarchy of widgets, and the application's X resource names follow this 
hierarchy. For example: 

Application . form . row . done . background : red 

In the resource name above, the top-level widget is named after the application. 
One of the top-level widget's children is a form widget, one of the form widget's 
children is a row -column manager widget, and one of the row-column manager 
widget's children is a pushbutton widget. Resource names show a path in the 
widget hierarchy. 

Each widget in the hierarchy is a member of a widget class, and the particular 
instance of the widget is named by the application programmer. 
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Class Names or Instance Names Can Be Used 

When specifying resource names, you can use either instance names or class names. 
For example, a "Done" pushbutton may have an instance name of "done" and a 
class name of "XmPushButton". To set the background color for a hypothetical 
"Done" pushbutton, you can use: 

Application . form . row . done . background : red 
Or, you can use: 

Application . form . row . XmPushButton . background : red 

Applications also have class and instance names. For example, an application may 
have an instance name of "applicl" and a class name of "Application". To set the 
background color for a hypothetical "Done" pushbutton only in the "applicl" 
application, you can use: 

applicl . form . row . done . background : red 

Note that instance names are more specific than class names. That is, class names 
may apply to many instances of the widget. 

The class and instance names for the widgets in the Graphical User Interface can be 
displayed by choosing Help— >X Resource Names and clicking on the "All names" 
button. 

Wildcards Can Be Used 

A wildcard may be used to match a resource specification to many different 
widgets at once. For example, to set the background color of all pushbuttons, you 
can use: 

Application*XmPushButton . background : red 

Note that resource names with wildcards are more general than those without 
wildcards. 
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Specific Names Override General Names 

A more specific resource specification will override a more general one when both 
apply to a particular widget or application. 

The names for the application and the main window widget in HP64_Softkey 
applications have been chosen so that you may specify custom resource values that 
apply in particular situations: 

1 Apply to ALL HP64_Softkey applications: 
HP64_Softkey*<resource>: <value> 

2 Apply to specific types of HP64_Softkey applications: 

emul*<resource>: <value> (for the emulator) 
perf*<resource>: <value> (for the performance analyzer) 

3 Apply to all HP64_Softkey applications, but only when they are connected to a 
particular type of microprocessor: 

*m68302*<resource>: <value> (for the 68302) 
*m68020*<resource>: <value> (for the 68020) 

4 Apply to a specific HP64_Softkey application connected to a specific 
processor: 

perf.m68302*<resource>: <value> (for the 68302 perf. analyzer) 
emul.m68020*<resource>: <value> (for the 68020 emulator) 

If all four examples above are used for a particular resource, #3 will override #2 for 
all applications connected to a 68302 emulator, and #4 will override #2, but only 
for the specifically mentioned type of microprocessor. 

When modifying resources, your resource paths must either match, or be more 
specific than, those found in the application defaults file. 

How X Resource Specifications are Loaded 

When the Graphical User Interface starts up, it loads resource specifications from a 
set of configuration files located in system directories as well as user-specific 
locations. 



541 



Chapter 15: Concepts 

X Resources and the Graphical User Interface 

Application Default Resource Specifications 

Default resource specifications for an application are placed in a system directory: 

HP-UX /usr/lib/Xll/app-defaults 

SunOS /usr/openwin/lib/Xl 1/app-defaults 

The name of the Graphical User Interface application defaults file is HP64_Softkey 
(same as the application class name). This file is well-commented and contains 
information about each of the X resources you can modify. You can easily view 
this file by choosing Help— >Topic and selecting the "X Resources: App Default 
File" topic. Do not modify the application defaults file; any changes to this file will 
affect the appearance and behavior of the application for all users. 

User-Defined Resource Specifications 

User-defined resources (for any X application) are located in the X server's 
RESOURCEJVIANAGER property or in the user's $HOME/.Xdefaults file. 

Load Order 

Resource specifications are loaded from the following places in the following order: 

5 The application defaults file. For example, 

/usr/lib/Xl l/app-defaults/HP64_Softkey when the operating system is HP-UX 
or /usr/openwin/lib/Xl l/app-defaults/HP64_Softkey when the operating 
system is SunOS. 

6 The $XAPPLRESDIR/HP64_Softkey file. (The XAPPLRESDIR environment 
variable defines a directory containing system-wide custom application 
defaults.) 

7 The server' s RESOURCE_M ANAGER property. (The xrdb command loads 
user-defined resource specifications into the RESOURCE_MANAGER 
property.) 

If no RESOURCE_MANAGER property exists, user defined resource settings 
are read from the $HOME/.Xdefaults file. 
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8 The file named by the XENVIRONMENT environment variable. 

If the XENVIRONMENT variable is not set, the $HOME/.Xdefaults-/j05f file 
is read (typically contains resource specifications for a specific remote host). 

9 Resource specifications included in the command line with the -xrm option. 

When specifications with identical resource names appear in different places, the 
latter specification overrides the former. 

Scheme Files 

Several of the Graphical User Interface's X resources identify scheme files that 
contain additional X resource specifications. Scheme files group resource 
specifications for different displays, computing environments, and languages. 

Resources for Graphical User Interface Schemes 

There are five X resources that identify scheme files: 

HP64_Softkey.labelScheme: 

Names the scheme file to use for labels and button text. Values can be: Label, 
$LANG, or a custom scheme file name. The default uses the $LANG 
environment variable if it is set and if a scheme file named Softkey.$LANG 
exists in one of the directories searched for scheme files; otherwise, the default 
is Label. 

HP64_Softkey.platformScheme: 

Names the subdirectory for the platform specific color, size, and input scheme 
files. This resource should be set to the platform on which the X server is 
running (and displaying the Graphical User Interface) if it is different than the 
platform where the application is running. Values can be: HP-UX, SunOS, 
pc-xview, or a custom platform scheme directory name. 

HP64_Softkey.colorScheme: 

Names the color scheme file. Values can be: Color, BW, or a custom scheme 
file name. 
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HP64_Softkey.sizeScheme: 

Names the size scheme file which defines the fonts and the spacing used. 
Values can be: Large, Small, or a custom scheme file name. 

HP64_Softkey.inputScheme: 

Names the input scheme file which specifies mouse and keyboard operation. 
Values can be: Input, or a custom scheme file name. 

The actual scheme file names take the form: "Softkey.<value>". 



Scheme File Names 

There are six scheme files provided with the Graphical User Interface. Their names 
and brief descriptions of the resources they contain follow. 



Softkey .Label Defines the labels for the fixed text in the interface. Such 

things as menu item labels and similar text are in this file. 
If the $LANG environment variable is set, the scheme file 
"Softkey.$LANG" is loaded if it exists; otherwise, the file 
"Softkey .Label" is loaded. 

Softkey .BW Defines the color scheme for black and white displays. This 

file is chosen if the display cannot produce at least 16 
colors. 



Softkey .Color Defines the color scheme for color displays. This file is 

chosen if the display can produce 16 or more colors. 

Softkey .Large Defines the size scheme (that is, the window dimensions 

and fonts) for high resolution displays (1000 pixels or more 
vertically). 

Softkey.Small Defines the size scheme (that is, the window dimensions 

and fonts) for low resolution displays (less than 1000 pixels 
vertically). 

Softkey .Input Defines the input scheme (that is, the button and key 

bindings for the mouse and keyboard). 
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Load Order for Scheme Files 

Scheme files are searched for in the following directories and in the following order: 

10 System scheme files in directory $HP64000/lib/Xl l/HP64_schemes. 

1 1 System-wide custom scheme files located in directory 
$XAPPLRESDIR/HP64_schemes. 

12 User-defined scheme files located in directory $HOME/.HP64_schemes (note 
the dot in the directory name). 

Custom Scheme Files 

You can modify scheme files by copying them to the directory for user-defined 
schemes and changing the resource specifications in the file. For example, if you 
wish to modify the color scheme, and your platform is HP-UX, you can copy the 
$HP64000/lib/Xl l/HP64_schemes/HP-UX/Softkey .Color file to 
$HOME/.HP64_schemes/HP-UX/Softkey.Color and modify its resource 
specifications. 

You can create custom scheme files by modifying the X resource for the particular 
scheme and by placing the custom scheme file in the directory for user-defined 
schemes. For example, if the following resource specifications are made: 

HP 64_Sof tkey . plat f ormScheme : HP-UX 
HP64_Softkey . color Scheme : MyColor 

The custom scheme file would be: 

SHOME/ . HP 64_schemes /HP-UX/ Sof tkey .MyColor 
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Installation 



This chapter shows you how to install emulation and analysis hardware and 
interface software. It also shows you how to verify installation by starting the 
emulator analyzer interface for the first time. These installation tasks are described 
in the following sections: 

• Installing hardware. 

• Connecting the HP 64700 to a computer or LAN. 

• Installing HP 9000 software. 

• Installing Sun SPARCsystem software. 

• Verifying the installation. 

Minimum HP 9000 Hardware and System Requirements 

The following is a set of minimum hardware and system recommendations for 
operation of the Graphical User Interface on HP 9000 Series 300/400 and Series 
700 workstations. 

HP-UX For Series 9000/300 and Series 9000/400 workstations, the minimum 
supported version of the operating system is 7.03 or later. For Series 9000/700 
workstations, the minimum supported version of the operating system is version 
8.01. 

Motif/OSF For Series 9000/700 workstations, you must also have the Motif 1.1 
dynamic link libraries installed. They are installed by default, so you do not have to 
install them specifically for this product, but you should consult your HP-UX 
documentation for confirmation and more information. 

Hardware and Memory Any workstation used with the Graphical User 
Interface should have a minimum of 16 megabytes of memory. Series 300 
workstations should have a minimum performance equivalent to that of a 
HP 9000/350. A color display is also highly recommended. 
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From here, you should proceed to the section titled "Installation for HP 9000 
Hosted Systems" for instructions on how to install, verify, and start the Graphical 
User Interface on HP 9000 systems. 

Minimum Sun SPARCsystem Hardware and System Requirements 

The following is a set of minimum hardware and system recommendations for 
operation of the Graphical User Interface on Sun SPARCsystem workstations. 

SunOS The Graphical User Interface software is designed to run on a Sun 
SPARCsystem with SunOS version 4.1 or 4.1.1 or greater. The tape uses the 
QIC -24 data format. 

64700 Operating Environment The Graphical User Interface requires version 
A.04.10 or greater of the 64700 Operating Environment. (The Graphical User 
Interface version is A.04.00.) 

Hardware and Memory Any workstation used with the Graphical User 
Interface should have a minimum of 16 megabytes of memory. A color display is 
also highly recommended. 

From here, you should proceed to the section titled "Installation for Sun 
SPARCsystems" for instructions on how to install, verify, and start the Graphical 
User Interface on SPARCsystem workstations. 
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Installing Hardware 

This section describes how to install emulation and analysis hardware. 

Equipment supplied 

The minimum system contains: 

• HP 64700 Card Cage. 

• One of the following emulators: 

- HP 64746A/G 68302 Emulator, 128 Kbytes emulation memory. 

- HP 64746B/H 68302 Emulator, 512 Kbytes emulation memory. 

- HP 64746J 68302 Emulator, uses the HP 64170 memory board which 
can contain up to 4 Mbytes of emulation memory. 

• HP 64703 A 64-Channel Emulation Bus Analyzer and 16-Channel External 
State/Timing Analyzer. 

Optional parts are: 

• HP 64704A 80-Channel Emulation Bus Analyzer (instead of HP 64703A). 

• HP 64706A 48-Channel Emulation Bus Analyzer (instead of HP 64703A). 

Equipment and tools needed 

In order to install and use the 68302 emulation system, you need: 

• Host computer or terminal with RS-232/RS-422 port. 

• RS-232/RS-422 cable. 

• Flat-blade screwdriver. 

Installation overview 

The steps in the installation process are: 

1 Install emulator and analyzer boards into the HP 64700 Card Cage. 

2 Apply power to the HP 64700 . 

Your emulation and analysis system may already be assembled (depending on how 
parts of the system were ordered). 
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WARNING 



Step 1 . Install Boards into the HP 64700 Card 
Cage 



Before removing or installing parts in the HP 64700 Card Cage, make sure 
that the card cage power is off and that the power cord is disconnected. 



CAUTION 



Do NOT stand the HP 64700 on the rear panel. You could damage the rear panel 
ports and connectors. 



If your emulator and analyzer boards are already installed in the HP 64700 Card Cage, go to "Step 2. 
Connect the HP 64700 to a Host Computer or Terminal". 
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1 Use a ground strap when removing or installing boards into the HP 64700 Card Cage. A jack on the 
rear panel of the HP 64700 Card Cage is provided for this purpose. 




When removing or installing cards, you should use a ground strap to reduce the chances of damaging 
circuit cards from static discharge. 



554 



Chapter 16: Installation 
Step 1 . Install Boards into the HP 64700 Card Cage 



2 Turn the thumb screw and remove the top cover by sliding the cover toward the rear and up. 
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3 Remove the side cover by unsnapping the two latches and lifting off. 
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5 First, completely loosen the four egress thumb screws. 

To remove emulator cards, insert a flat blade screwdriver in the access hole and eject the emulator cards 
by rotating the screwdriver. 




AND PROBE CABLE AS AN ASSEMBLY 
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6 Insert a screw driver into the third slot of the right side of the front bezel, push to release catch, and 
pull the right side of the bezel about one half inch away from the front of the HP 64700. Then, do the 
same thing on the left side of the bezel. When both sides are released, pull the bezel toward you 
approximately 2 inches. 
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7 Lift the bezel panel to remove. Be careful not to put stress on the power switch extender. 




BE CAREFUL NOT TO 
PUT STRESS ON POWER 
SWITCH EXTENDER 



8 If you're removing an existing analyzer card that provides external analysis, remove the right angle 
adapter board by turning the thumb screws counter-clockwise. 
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9 To remove the analyzer card, insert a flat blade screwdriver in the access hole and eject the analyzer 
card by rotating the screwdriver. 




EJECT ANALYZER CARD 



Do not remove the system control board. This board is used in all HP 64700 emulation and analysis 
systems. 
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10 Install HP 64703A (or HP 64704/6) and HP 64746 boards. The HP 64703A (or HP 64704/6) is 
installed in the slot next to the system controller board. The HP 64746 boards are installed in the bottom 
two slots of the HP 64700 with the memory board above the board that has the emulator probe. These 
boards are identified with labels that show the model number and the serial number. 

To install a card, insert it into the plastic guides. Make sure the connectors are properly aligned; then, 
press the card into mother board sockets. Check to ensure that the cards are seated all the way into the 
sockets. If the cards can be removed with your fingers, the cards are NOT seated all the way into the 
mother board socket. 



5YSTEM CONTROLLER 



HP 64703M/6 
EMULATION BUS 
ANALYZER CARD 



MEMORY BOARD 
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11 If you installed the HP 64703A analyzer card, install the right angle adapter board by turning the 
thumb screws clockwise. 

Connect the external analyzer probe cable to the right angle adapter board. Each connector of the 
external analyzer cable is keyed so that it can be connected to the right angle adapter board in only one 
way. Check for bent connector pins before connecting the analyzer probe cable. Align the key of the 
external analyzer cable connector with the slot in the right angle adapter board, and gently press the 
external analyzer cable connector into the connector on the right angle adapter board. Position the cable 
as shown below. 
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15 Install the top cover in reverse order of its removal, but make sure that the side panels of the top cover 
are attached to the side clips on the frame. 
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Step 2. Apply power to the HP 64700 



The HP 64700B automatically selects the 1 15 Vac or 220 Vac range. In the 1 15 Vac range, the 

HP 64700B will draw a maximum of 345 W and 520 VA. In the 220 Vac range, the HP 64700B will 

draw a maximum of 335 W and 600 VA. 

The HP 64700 is shipped from the factory with a power cord appropriate for your country. You should 
verify that you have the correct power cable for installation by comparing the power cord you received 
with the HP 64700 with the drawings under the "Plug Type" column of the following table. 

If the cable you received is not appropriate for your electrical power outlet type, contact your 
Hewlett-Packard sales and service office. 
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Power Cord Configurations 



Plug Type 


Cable Part No. 


Plug Description 


Length in/cm 


Color 


Opt 903 




8120-1378 


Straight 


90/228 


Jade Gray 


124V ** 














a* 


8120-1521 


90° 


90/228 


Jade Gray 


Opt 900 




olZU-1 jj 1 


Straight 


on/9 os 

VU/ZZo 


Gray 


250V 






*BS136A 










8120-1703 


90° 


90/228 


Mint Gray 


Opt 901 




8120-1369 


Straight 


79/200 


Gray 


250V 
















8120-0696 


90° 


87/221 


Mint Gray 


Opt 902 




812001689 


Straight 


79/200 


Mint Gray 


250V 






* CEE7-Y1 1 










8120-1692 


90° 


79/200 


Mint Gray 








Straight 










8120-2857 


(Shielded) 


79/200 


Coco 












Brown 


* Part number shown for plug is industry identifier for plug only. 




Number shown for cable is HP part number for complete cable including plug. 




** These cords are included in the CSA certification approval for the equipment. 
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Power Cord Configurations (Cont'd) 



Plug Type 


Cable Part No. 


Plug Description 


Length in/cm 


Color 


Opt 906 
250V 


8120-2104 
8120-2296 


Straight 
* SEV1011 
1959-24507 
Type 12 
90° 


79/20 
79/200 


Mint Gray 
Mint Gray 


Opt 912 
220V 


8120-2957 


Straight 
*DHCK107 

90° 


79/200 
79/200 


Mint Gray 
Mint Gray 


Opt 917 
250V 


8120-4600 
8120-4211 


Straight 
SABS 164 
90° 


79/200 
79/200 


Jade Gray 


Opt 918 
100 V 


8120-4753 
8120-4754 


Straight Miti 
90° 


90/230 
90/230 


Dark Gray 


* Part number shown for plug is industry identifier for plug only. 

Number shown for cable is HP part number for complete cable including plug. 

** These cords are included in the CSA certification approval for the equipment. 
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1 Connect the power cord and turn on the HP 64700. 



The line switch is a push button located at the lower left hand corner of the front panel. To turn ON 
power to the HP 64700, push the line switch button in to the ON (1) position. The power light at the 
lower right hand corner of the front panel will be illuminated. 
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Connecting the HP 64700 to a Computer or LAN 

Refer to the HP 64700 Series Installation/Service Guide for instructions on 
connecting the HP 64700 to a host computer (via RS-422 or RS-232) or LAN and 
setting the HP 64700' s configuration switches. (RS-422 and RS-232 are only 
supported on HP 9000 Series 300/400 machines.) 



570 



Chapter 16: Installation 
Step 1 . Install the software from the media 



Installing HP 9000 Software 

This section shows you how to install the Graphical User Interface on HP 9000 
workstations. These instruction also tell you how not to install the Graphical User 
Interface if you want to use just the conventional Softkey Interface. 

This section shows you how to: 

1 Install the software from the media. 

2 Verify the software installation. 

3 Start the X server and the Motif Window Manager (mwm), or start HP VUE. 

4 Set the necessary environment variables. 



Step 1. Install the software from the media 

The tape that contains the Graphical User Interface software may contain several 
products. Usually, you will want to install all of the products on the tape. 
However, to save disk space, or for other reasons, you can choose to install selected 
filesets. 

If you plan on using the Softkey Interface instead of the Graphical User Interface, 
you can save about 3.5 megabytes of disk space by not installing the XUI suffixed 
filesets in the "64700 Operating Environment" and "<processor-type> Emulation 
Tools" partitions. (Also, if you choose not to install the Graphical User Interface, 
you will not have to use a special command line option to start the Softkey 
Interface.) 

Refer to the information on updating HP-UX in your HP-UX documentation for 
instructions on viewing partitions and filesets and marking filesets that should not 
be loaded. 

The following sub-steps assume that you want to install all products on the tape. 
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1 Become the root user on the system you want to update. 

2 Make sure the tape's write-protect screw points to SAFE. 

3 Put the product media into the tape drive that will be the source device for the 
update process. 

4 Confirm that the tape drive BUSY and PROTECT lights are on. If the PROTECT 
light is not on, remove the tape and confirm the position of the write-protect screw. 
If the BUSY light is not on, check that the tape is installed correctly in the drive 
and that the drive is operating correcdy. 

5 When the BUSY light goes off and stays off, start the update program by entering 
/etc/update 

at the HP-UX prompt. 

6 When the HP-UX update utility main screen appears, confirm that the source and 
destination devices are correct for your system. Refer to the information on 
updating HP-UX in your HP-UX documentation if you need to modify these values. 

7 Select "Load Everything from Source Media" when your source and destination 
directories are correct. 

8 To begin the update, press the softkey <Select Itemx At the next menu, press the 
softkey <Select Item> again. Answer the last prompt with 

y 

It takes about 20 minutes to read the tape. 

9 When the installation is complete, read /tmp/update.log to see the results of the 
update. 
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Step 2. Verify the software installation 

A number of new filesets were installed on your system during the software 
installation process. This and following steps assume that you chose to load the 
Graphical User Interface filesets. 

You can use this step to further verify that the filesets necessary to successfully 
start the Graphical User Interface have been loaded and that customize scripts have 
run correctly. Of course, the update process gives you mechanisms for verifying 
installation, but these checks can help to double-check the install process. 

1 Verify the existence of the HP64_Softkey file in the /usr/lib/Xll/app-defaults 

subdirectory by entering 

Is /usr/lib/Xll/app-defaults/HP64_Softkey at the HP-UX prompt. 

Finding this file verifies that you loaded the correct fileset and also verifies that the 
customize scripts executed because this file is created from other files during the 
customize process. 

2 Examine /usr/lib/Xll/app-defaults/HP64_Softkey near the end of the file to 
confirm that there are resources specific to your emulator. 

Near the end of the file, there will be resource strings that contain references to 
specific emulators. For example, if you installed the Graphical User Interface for 
the 68302 emulator, resource name strings will have m68302 embedded in them. 

After you have verified the software installation, you must start the X server and an 
X window manager (if you are not currently running an X server). If you plan to 
run the Motif Window Manager (mwm), or similar window manager, continue with 
Step 3a of these instructions. If you plan to run HP VUE, skip to Step 3b of these 
instructions. 
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Step 3a. Start the X server and the Motif Window 
Manager (mwm) 

If you are not already running the X server and a window manager, do so now. The 
X server is required to use the Graphical User Interface because it is an X Windows 
application. A window manager is not required to execute the interface, but, as a 
practical matter, you must use some sort of window manager with the X server. 

• Start the X server by entering xllstart at the HP-UX prompt. 

Consult the X Window documentation supplied with the HP-UX operating system 
documentation if you do not know about using X Windows and the X server. 

After starting the X server and Motif Window Manager, continue with step 4 of 
these instructions. 



Step 3b. Start HP VUE 

If you are running the X server under HP VUE and have not started HP VUE, do so 
now. 

HP VUE is a window manager for the X Window system. The X server is 
executing underneath HP VUE. Unlike the Motif Window Manager, HP VUE 
provides a login shell and is your default interface to the HP 9000 workstation. 



Step 4. Set the necessary environment variables 

The DISPLAY environment variable must be set before the Graphical User 
Interface will start. Also, you should modify the PATH environment variable to 
include the "/usr/hp64000/bin" directory, and, if you have installed software in a 
directory other than "/", you need to set the HP64000 environment variable. 
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The following instructions show you how to set these variables at the UNIX 
prompt. Modify your ".profile" or ".login" file if you wish these environment 
variables to be set when you log in. The following instructions also assume that 
you're using "sh" or "ksh"; if you're using "csh", environment variables are set 
using the "setenv <VARIABLE> <value>" command. 

1 Set the DISPLAY environment variable by entering 

DISPLAY=<hostname>:<server_number>.<screen_number> 
export DISPLAY 

For example: 

DISPLAY=myhost:0.0; export DISPLAY 

Consult the X Window documentation supplied with the UNIX system 
documentation for an explanation of the DISPLAY environment variable. 

2 Set the HP64000 environment variable. 

For example, if you installed the HP 64000 software relative to the root directory, 
"/", you would enter 

HP64000=/usr/hp64000; export HP64000 

If you installed the software relative to a directory other than the root directory, it is 
strongly recommended that you use a symbolic link to make the software appear to 
be under /usr/hp64000. For example, if you installed the software relative to 
directory /users/team, you would enter 

In -s /users/team/usr/hp64000 /usr/hp64000 

If you do not wish to establish a symbolic link, you can set the HP64000 variable to 
the full path that contains the HP 64000 software. Again, if you installed relative to 
/users/team, you would enter 

HP64000=/users/team/usr/hp64000; export HP64000 
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3 Set the PATH environment variable to include the usr/hp64000/bin directory by 
entering 

PATH=$PATH:$HP64000/bin; export PATH 

Including usr/hp64000/bin in your PATH relieves you from prefixing HP 64700 
executables with the directory path. 

4 Set the MANPATH environment variable to include the usr/hp64000/man and 
usr/hp64000/contrib/man directories by entering 

MANPATH=$MANPATH:$HP64000/man:$HP64000/contrib/man 
export MANPATH 

Including these directories in your MANPATH variable lets you access the on-line 
"man" page information included with the software. 
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Installing Sun SPARCsystem Software 

This section shows you how to install the Graphical User Interface on Sun 
SPARCsystem workstations. These instructions also tell you how not to install the 
Graphical User Interface if you want to use just the conventional Softkey Interface. 

This section shows you how to: 

1 Install the software from the media. 

2 Start the X server and Open Windows. 

3 Set the necessary environment variables. 

4 Verify the software installation. 

5 Map your function keys. 



Step 1. Install the software from the media 

The tape that contains the Graphical User Interface software may contain several 
products. Usually, you will want to install all of the products on the tape. 
However, to save disk space, or for other reasons, you can choose to install selected 
filesets. 

If you plan on using the conventional Softkey Interface instead of the Graphical 
User Interface, you can save about 3.5 megabytes of disk space by not installing the 
XUI suffixed filesets. (Also, if you choose not to install the Graphical User 
Interface, you will not have to use a special command line option to start the 
Softkey Interface.) 

Refer to the Software Installation Notice for software installation instructions. 
After you are done installing the software, return here. 
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Step 2. Start the X server and OpenWindows 

If you are not already running the X server, do so now. The X server is required to 
run the Graphical User Interface because it is an X application. 

• Start the X server by entering /usr/openwin/biii/openwin at the UNIX prompt. 

Consult the OpenWindows documentation if you do not know about using 
OpenWindows and the X server. 



Step 3. Set the necessary environment variables 

The DISPLAY environment variable must be set before the Graphical User 
Interface will start. Also, you should modify the PATH environment variable to 
include the "usr/hp64000/bin" directory, and, if you have installed software in a 
directory other than "/", you need to set the HP64000 environment variable. 

The following instructions show you how to set these variables at the UNIX 
prompt. Modify your ".profile" or ".login" file if you wish these environment 
variables to be set when you log in. The following instructions also assume that 
you're using "csh"; if you're using "sh", environment variables are set in the 
"<VARIABLE>=<value>; export <VARIABLE>" form. 

1 The DISPLAY environment variable is usually set by the openwin startup script. 
Check to see that DISPLAY is set by entering 

echo $DISPLAY 

If DISPLAY is not set, you can set it by entering 

setenv DISPLAY=<hostname>:<server_number>.<screen_number> 
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For example: 

setenv DISPLAY=myhost:0.0 

Consult the Open Windows documentation for an explanation of the DISPLAY 
environment variable. 

2 Set the HP64000 environment variable. 

For example, if you installed the HP 64000 software relative to the root directory, 
"/", you would enter 

setenv HP64000 /usr/hp64000 

If you installed the software relative to a directory other than the root directory, it is 
strongly recommended that you use a symbolic link to make the software appear to 
be under /usr/hp64000. For example, if you installed the software relative to 
directory /users/team, you would enter 

In -s /users/team/usr/hp64000 /usr/hp64000 

If you do not wish to establish a symbolic link, you can set the HP64000 variable to 
the full path that contains the HP 64000 software; also set the 
LD_LIBRARY_PATH variable to the directory containing run-time libraries used 
by the HP 64000 products. Again, if you installed relative to /users/team, you 
would enter 

setenv HP64000 /users/team/usr/hp64000 

setenv LD_LIBRARY_PATH ${LD_LIBRARY_PATH}:${HP64000}/lib 

3 Set the PATH environment variable to include the usr/hp64000/bin directory by 
entering 

setenv PATH ${PATH}:${HP64000}/bin 

Including usr/hp64000/bin in your PATH relieves you from prefixing HP 64700 
executables with the directory path. 
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4 Set the MANPATH environment variable to include the usr/hp64000/man and 
usr/hp64000/contrib/man directories by entering 

setenv MANPATH ${MANPATH}:${HP64000}/man 
setenv MANPATH ${MANPATH}:${HP64000}/contrib/man 

Including these directories in your MANPATH variable lets you access the on-line 
"man" page information included with the software. 

5 If the Graphical User Interface is to run on a SPARCsystem computer that is not 
running Open Windows, include the /usr/openwin/lib directory in 
LD_LIBRARY_PATH. 

setenv LD_LIBRARY_PATH ${LD_LIBRARY_PATH}:/usr/open win/lib 



Step 4. Verify the software installation 

A number of product filesets were installed on your system during the software 
installation process. Due to the complexity of installing on NFS mounted file 
systems, a script that verifies and customizes these products was also installed. 
This stand alone script may be run at any time to verify that all files required by the 
products are in place in the file system. If required files are not found, this script 
will attempt to symbolically link them from the $HP64000 install directory to their 
proper locations. 

• Run the script $HP64000/bin/envinstall. 
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Step 5. Map your function keys 

If you are using the conventional Softkey Interface, map your function keys by 
following the steps below. 

1 Copy the function key definitions by typing: 
cp $HP64000/etc/ttyswrc -/.ttyswrc 

This creates key mappings in the .ttyswrc file in your $HOME directory. 

2 Remove or comment out the following line from your .xinitrc file: 

xmodmap -e 'keysym Fl = Help' 

If any of the other keys F1-F8 are remapped using xmodmap, comment out those 
lines also. 

3 Add the following to your .profile or .login file: 

stty erase 
setenv KEYMAP sun 

The erase character needs to be set to backspace so that the Delete key can be used 
for "delete character." 

If you want to continue using the Fl key for HELP, you can use use F2-F9 for the 
Softkey Interface. All you have to do is set the KEYMAP variable. If you use 
Open Windows, type: 

setenv KEYMAP sun.2-9 

If you use xterm windows (the xterm window program is located in the directory 
/usr/openwin/demo), type: 

setenv KEYMAP xterm.2-9 

Reminder: If you are using Open Windows, add /usr/openwin/bin to the end of the 
$PATH definition, and add the following line to your .profile: 

setenv OPENWINHOME /usr/openwin 

After you have mapped your function keys, you must start the X server and an X 
window manager (if you are not currently running an X server). 
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Verifying the Installation 

This section shows you how to: 

• Determine the logical name of your emulator. 

• Start the emulator/analyzer interface for the first time. 

• Exit the emulator/analyzer interface. 



Step 1 . Determine the logical name of your 
emulator 

The logical name of an emulator is a label associated with a set of communications 
parameters in the $HP64000/etc/64700tab.net file. The 64700tab.net file is placed 
in the directory as part of the installation process. 

1 Display the 64700tab.net file by entering 

more /usr/hp64700/etc/64700tab.net at the HP-UX prompt. 

2 Page through the file until you find the emulator you are going to use. 

This step will require some matching of information to an emulator, but it should 
not be difficult to determine which emulator you want to address. 



Examples A typical entry for a 68302 emulator connected to the LAN would appear as 

follows: 

# 

# Channel I Logical | Processor | Remainder of Information for the Channel 

# Type I Name I Type I (IP address for LAN connections) 

# 

lan: em68302 m68302 21.17.9.143 
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A typical entry for a 68302 emulator connected to an RS-422 port would appear as 
follows: 

# 

# I I || I Xpar | Parity I Flow | Stop I Char 

# Channel I Logical I Processor | Host I Physical |Mode| | |Bits|Size 

# Type I Name I Type I Name I Device I I I XON | 

# I I || I OFF | NONE | RTS I 2 8 

# 

serial: em68302 m68302 myhost /dev/emcom23 OFF NONE RTS 2 8 



Step 2. Start the interface with the emul700 
command 

1 Apply power to the emulator you wish to access after making sure the emulator is 
connected to the LAN or to your host system. 

On the HP 64700 Series Emulator, the power switch is located on the front panel 
near the bottom edge. Push the switch in to turn power on to the emulator. 

2 Wait a few seconds to allow the emulator to complete its startup initialization. 

3 Choose a terminal window from which to start the Graphical User Interface. 



4 Start the Graphical User Interface by entering emul700 command and giving the 
logical name of the emulator as an argument to the command, as in 

$HP64000/bin/emul700 <logical_name> & 

or 

emul700 <logical name> & 
if $HP64000/bin is in your path. 

If you are running the X server, if the Graphical User Interface is installed, and if 
your DISPLAY environment variable is set, the emul700 command will start the 
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Graphical User Interface. Otherwise, emul700 starts the conventional Softkey 
Interface. 

You should include an ampersand ("&") with the command to start the Graphical 
User Interface as a background process. Doing so frees the terminal window where 
you started the interface so that the window may still be used. 

5 Optionally start additional Graphical User Interface windows into the same 
emulation session by repeating the previous step. 

You can also choose to use the conventional Softkey Interface under X Windows, 
but you must include a command line argument to emul700 to override the default 
Graphical User Interface. Start the conventional interface by entering 

emul700 -u skemul <logical name> 



Example Suppose you have discovered that the logical name for a 68302 emulator connected 

to the LAN is "em68302". To start the Graphical User Interface and begin 
communicating with that emulator, enter (assuming your $PATH includes 
$HP64000/bin) 

emul7 00 em68302 

After a few seconds, the Graphical User Interface Emulator/Analyzer window 
should appear on your screen. The window will be similar to the following: 
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lewlett Packard Emulator/Analyzer: etn68302 (m68302)| 
File Display Modify Execution Breakpoints Trace Settings 



Help 



Action keys: | < Demo > [| DispSrcQ [| Trace () [ Run [| Step Source 



|j=JY^oj£K^y>J| Make |l)isp Src Prev |Run Xferto ( ) [ Break | [_S^ejpjAsm 



EE3 



STATUS: 



Starting new session 
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Step 3. Exit the Graphical User Interface 

1 Position the mouse pointer over the pulldown menu named "File" on the menu bar 
at the top of the interface screen. 

2 Press and hold the command select mouse button until the File menu appears. 

3 While continuing to hold the mouse button down, move the mouse pointer down 
the menu to the "Exit" menu item. 

4 Display the Exit cascade menu by moving the mouse pointer to the right edge of 
the Exit menu choice. There is an arrow on the right edge of the menu item. 

5 Choose "Released" from the cascade menu. 

The interface will terminate and release the emulator for use by others. 
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access mode Specifies the types of cycles used to access target system memory 
locations. For example a "byte" access mode tells the monitor program to use 
load/store byte instructions to access target memory. 

analyzer An instrument that captures data on signals of interest at discreet 
periods. 

background The emulator mode in which foreground operation is suspended so 
the emulation processor can be used for communication with the emulation 
controller. The background monitor does not occupy any processor address space. 

background emulation monitor An emulation monitor program that does not 
execute as part of the user program, and therefore, operates in the emulator's 
background mode. 

background memory Memory space reserved for the emulation processor 
when it is operating in the background mode. Background memory does not take 
up any of the microprocessor's address space. 

display mode When displaying memory, this mode tells the emulator the size of 
the memory locations to display. When modifying memory, the display mode tells 
the emulator the size of the values to be written to memory. 

embedded microprocessor system The microprocessor system which the 
emulator plugs into. 

emulation bus analyzer The internal analyzer that captures emulator bus cycle 
information synchronously with the processor's clock signal. 

emulation monitor program A program that is executed by the emulation 
processor which allows the emulation controller to access target system resources. 
For example, when you display target system memory locations, the monitor 
program executes microprocessor instructions that read the target memory locations 
and send their contents to the emulation controller. 
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emulator An instrument that performs just like the microprocessor it replaces, but 
at the same time, it gives you information about the operation of the processor. An 
emulator gives you control over target system execution and allows you to view or 
modify the contents of processor registers, target system memory, and I/O 
resources. 

foreground The mode in which the emulator is executing the user program. In 
other words, the mode in which the emulator operates as the target microprocessor 
would. 

global restart When the same secondary branch condition is used for all terms in 
the analyzer's sequencer, and secondary branches are always back to the first term. 

prestore The analyzer feature that allows up to two states to be stored before 
normally stored states. This feature is useful when you want to find the cause of a 
particular state. For example, if a variable is accessed from many different places in 
the program, you can qualify the trace so that only accesses of that variable are 
stored and turn on prestore to find out where accesses of that variable originate 
from. 

primary sequencer branch Occurs when the analyzer finds the primary branch 
state specified at a certain level and begins searching for the states specified at the 
primary branch's destination level. 

real-time Refers to continuous execution of the user program without 
interference from the emulator. (Such interference occurs when the emulator 
temporarily breaks into the monitor so that it can access register contents or target 
system memory or I/O.) 

secondary sequencer branch Occurs when the analyzer finds the secondary 
branch state specified at a certain level before it found the primary branch state and 
begins searching for the states specified at the secondary branch's destination level. 

sequence terms Individual levels of the sequencer. The HP 64705A analyzer 
provides 8 sequence terms. 

sequencer The part of the analyzer that allows it to search for a certain sequence 
of states before triggering. 



Glossary 



sequencer branch Occurs when the analyzer finds the primary or secondary 
branch state specified at a certain level and begins searching for the states specified 
at another level. 

target system The microprocessor system which the emulator plugs into. 

trace A collection of states captured on the emulation bus (in terms of the 
emulation bus analyzer) or on the analyzer trace signals (in terms of the external 
analyzer) and stored in trace memory. 

trigger The captured analyzer state about which other captured states are stored. 
The trigger state specifies when the trace measurement is taken. 
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! 68302 chip selects, 137 
68302 internal DMA, 128 
68302 internal memory space 
mapping, 121 

A about, trigger position specification, 256 
absolute count, in the trace display, 280 
absolute files, 421 
loading, 181 

loading without symbols, 182 

storing memory contents into, 182 
absolute status, in the trace display, 274 
access mode, 587 
access size (target memory), 134 
action keys, 26 

custom, 364 

operation, 73 

with command files, 364 

with entry buffer, 71, 73 
activity measurements (SPMT), 291-305 

additional symbols for address, 299 

confidence level, 300 

error tolerance, 300 

interpreting reports, 298 

mean, 298 

relative and absolute counts, 299 

standard deviation, 299 

symbols within range, 299 

trace command setup, 293 
address (analyzer state qualifier softkey), 254, 443, 458 
address lines driven during background, 135 
address overlays, memory mapping, 125 
address qualifiers, 254 

address range file format (SPMT measurements), 295 

after, trigger position specification, 256 

altitude, operating and non-operating environments, 534 



591 



ambiguous address error message, 125 
analyzer, 587 

arbitration analysis, 129 

arming other HP 64700 Series analyzers, 5 

breaking emulator execution into the monitor, 4 

breaking execution of other HP 64700 Series emulators, 5 

count qualifiers, 262 

definition, 4 

general description, 4 

occurrence count, 259 

prestore qualifiers, 261 

state qualifiers, 254 

storage qualifiers, 260 

trace at EXECUTE, 343 

trigger condition, 256 

using the, 242 
analyzer probe 

assembling, 322 

connecting to the target system, 324 
analyzer status 

occurrence left information, 246 

sequence term information, 246 
app-defaults directory 

HP 9000 computers, 542 

Sun SPARCsystem computers, 542 
application resource 

See X resource 
arbitration analysis, 129 
arm information, 245 
arm_trig2, in trace command, 472 

background, 112-113, 587 

address driven, 135 

driving target system during, 135 

emulation monitor, 587 

memory, 587 

tracing, 140 
background execution, tracing, 140 
background function codes driven, 135 
background monitor, 113 

FRZ asserted, 115 

selecting, 112-119 



BAR register, 121 

bases (number), 251 

bbaunload command, syntax, 384 

before, trigger position specification, 256 

BERR, response to during target memory cycles, 131 

binary numbers, 251 

BNC 

connector, 5, 336 

trigger signal, 338 
BR0-BR3 registers, 137 
break 

write to ROM, 117 
break command, 197 

syntax, 383 
break on guarded memory access, 264 
breakpoints, 34 

screen to file, 235 

TRAP instruction, 139 
breaks on write to ROM, 138 
bus arbitration 

analysis of, 129 

configure emulator's response, 128 

using configuration to isolate target problem, 98, 128 
bus error response, 131 
bus width (data), setting, 134 

cables 

emulator probe, length, 533 

power, 566 
cascade menu, 64 
cautions 

BNC accepts only TTL voltage levels, 341 
CMB 9-pin port is NOT for RS-232C, 339 
do not use probe without pin extender, 145 
emulator suspension rating of 29.5 kg, 533 
powering OFF the HP 64700, 144 
protect emulator against static discharge, 143 
real-time dependent target system circuitry, 110 
rear panel, do not stand HP 64700 on, 553 
changing 

directory context in configuration window, 105 
directory context in emulator/analyzer window, 192 



symbol context, 193 
characteristics of emulation probe, 528 
characteristics, emulator, 528-534 
characterization of memory, 121 
class name, X applications, 540 
client, X, 356 

clock source selection, emulator configuration, 108 
clocks 

See also slave clocks 
closing 

emulator/ analyzer windows, 59 
CMB (coordinated measurement bus), 336 

EXECUTE line, 338, 385 

HP 64700 connection, 339 

READY line, 337 

signals, 337 

TRIGGER line, 337 
cmb_execute command, 344, 385 
color scheme, 358, 362, 544 
column width, trace display option, 279 
columns in main display area, 359 
command buttons, 27 
command files, 423 

other things to know about, 88 

passing parameters, 87 
command line, 27 

Command Recall dialog box, 28 

Command Recall dialog box, operation, 82 

copy-and-paste to from entry buffer, 72 

editing entry area with popup menu, 81 

editing entry area with pushbuttons, 80 

entering commands, 79 

entry area, 27 

executing commands, 79 

help, 82 

keyboard use of, 83-85 
on-line help, 85 

recalling commands with dialog box, 82 

turning on or off, 78, 359 
command paste mouse button, 29 
Command Recall dialog box operation, 74 



command select mouse button, 29 
commands, 83 

combining on a single command line, 83 

completion, 83 

editing in command line entry area, 80-81 
entering in command line, 79 
executing in command line, 79 
keyboard entry, 83 
line erase, 84 
map, 126 
recall, 84 

recalling with dialog box, 82 

summary, 382 

word selection, 84 
communications ports 

electrical characteristics, 533 

physical characteristics, 533 
comparison of foreground/background monitors, 114 
configuration (emulator) 

A23-A16 values for driven background cycles, 135 

background states, tracing, 140 

breaks on writes to ROM, 138 

bus arbitration enable/disable, 128 

bus error response, 131 

data bus width, 134 

drive background cycles to target, 135 

DTACK interlock, 130 

function codes for driven background cycles, 135 

inverse assembly syntax, 111 

monitor entry after, 109 

monitor selection, 112-119 

supervisor stack pointer reset value, 133 

target system interrupts enable/disable, 132 

TRAP instruction for breakpoint, 139 
configuration context 

displaying from configuration window, 106 
configuration, emulator 

exiting the interface, 107 

loading from file, 107 

modifying a section, 102 

starting the interface, 100 



storing, 104 
context 

changing directory in configuration window, 105 
changing directory in emulator/analyzer window, 192 
changing symbol, 193 

displaying directory from configuration window, 106 
displaying directory from emulator/analyzer window, 192 
displaying symbol, 192 

coordinated measurements, 345 

break_on_trigger syntax of the trace command, 345 

definition, 336 
copy command, 386-388 

data, 387 

display, 387 

error_log, 387 

event_log, 387 

global symbols, 387 

help, 387 

local_symbols_in, 389 

memory, 390-391 

pod_command, 388 

registers, 392 

software breakpoints, 388 

status, 388 

trace, 393 
copy-and-paste 

addresses, 69 

from entry buffer, 72 

multi-window, 69, 72 

symbol width, 69 

to entry buffer, 68 
copying 

breakpoints screen to file, 235 

data values screen to file, 235 

display area to file, 235 

emulator status screen to file, 236 

error log to file, 236 

event log to file, 236 

global symbols to file, 236 

local symbols to file, 236 

memory to file, 235 



pod commands screen to file, 236 

registers to file, 235 

trace listing to file, 235 
count absolute/relative, trace display option, 280 
count qualifiers, 262 
count, occurrence, 259 
cursor buttons, 28 

data 

copy command, 387 

display command, 396-398 
data (analyzer state qualifier softkey), 254, 443, 458 
data (external), trace display option, 283 
data bus width, 134 
data value 

screen to file, 235 
data values, 224-225 

adding items to the existing display, 225 

clearing the display and adding a new item, 225 

displaying, 224 
data values, displaying, 38 
decimal numbers, 251 
default trace command, 244 
default trace display 

returning to, 282 
demos, setting up, 367-369 
demultiplexing, using slave clocks for, 329 
demux, slave clock mode, 331 
depth of the trace, 250 
device table file, 32, 53-54 
dialog box, 73 

Command Recall, operation, 74, 82 

Directory Selection, 192 

Directory Selection, operation, 73, 76 

Entry Buffer Recall, operation, 71, 74 

File Selection, operation, 74-75 

Trace Specification Selection, operation, 250 
dimensions 

emulator, 533 
directory context 

changing in configuration window, 105 

changing in emulator/analyzer window, 192 



displaying from configuration window, 106 

displaying from emulator/analyzer window, 192 
Directory Selection dialog box operation, 73, 76 
display area, 27 

columns, 359 

lines, 359-360 

screen to file, 235 
display command, 394-395 

data, 396-398 

error_log, 394 

event_log, 395 

global_symbols, 399 

local_symbols_in, 400 

memory, 401-404 

memory mnemonic, 33, 219 

pod_command, 395 

registers, 213-217, 405 

simulated_io, 406 

software_breakpoints, 407 

status, 244, 395 

symbols, 183 

trace, 248, 408-411 
DISPLAY environment variable, 575, 578 
display mode, 587 
display trace, 271-283 

about line number, 272-273 

absolute format, 274 

count absolute/relative, 280 

default, 282 

external data, 283 

mnemonic format, 275 

offset by, 281 

positioning, left/right, 249 

positioning, up/down, 249 

source line inclusion, 276 

symbol information inclusion, 278 

width of columns, 279 
displaying 

registers, 216 

simulated io screen, 237, 239 
displays, copying, 387 



DMA limitations, 128 

DMA, internal 68302, 128 

don't care digits, 252 

downloading absolute files, 5, 181 

driving background cycles to target system, 135 

DTACK, 137 

interlock, needed for correct bus error response, 131 

source, emulator configuration, 137 
DTACK interlock, 130 
DTACK when out-of -circuit, 130 
dual-port emulation memory, 110 
dummy part, 148 

duration measurements (SPMT), 306-314 
average time, 311 
confidence level, 312 
error tolerance, 312 
interpreting reports, 311 
maximum time, 311 
minimum time, 311 
number of intervals, 311 
recursion considerations, 306 
selecting, 309 
standard deviation, 312 
trace command setup, 307 

editing 

command line entry area with popup menu, 81 

command line entry area with pushbuttons, 80 

file, 232, 359 

file at address, 232, 359 

file at program counter, 232 

file at symbol from symbols screen, 232 

file from memory display screen, 232 
electrical characteristics of the emulator, 528 
embedded microprocessor system, 587 

emul700, command to start the emulator/analyzer interface, 53 
emulation bus analyzer, 587 
emulation memory, 120 

dual-port, 110 

loading absolute files, 181 

size of, 120 
emulation monitor, 587 



foreground or background, 112-119 

function of, 112 
emulation session 

exiting, 60 
emulation, external analyzer mode, 328 
emulator, 588 

bus error response, 131 

configuring the, 96 

data bus width, 134 

device table file, 32, 53-54 

dimensions, 533 

electrical characteristics, 528 

environmental characteristics of, 534 

error messages, 503 

general description, 4 

multiple start/stop, 5, 343-344 

physical characteristics, 533 

plugging into a target system, 142 

probe cable length, 533 

running from target reset, 195 

specifications and characteristics, 528-534 

status lines, predefined values for, 256 

using the, 180 

weight, 533 
emulator configuration 

address driven during background, 135 

arbitration analysis, 129 

background cycles driven to target, 135 

break processor on write to ROM, 138 

bus arbitration, 128 

bus error response, 131 

clock selection, 108 

data bus width, 134 

DTACK interlock, 130 

DTACK source, 137 

exiting the configuration interface, 107 

function codes driven during background, 135 

IACK7 pin, 135 

interrupt mode, 132 

inverse assembly syntax, 111 

IRQ7 mode, 132 



load command, 422 

loading from file, 107 

modify command, 425 

modifying a configuration section, 102 

monitor entry after, 109 

restrict to real-time runs, 110 

starting the configuration interface, 100 

storing, 104 

supervisor stack pointer reset value, 133 

target memory access size, 134 

target system interrupts enable/disable, 132 

trace background/foreground operation, 140 

TRAP instruction for breakpoint, 139 
emulator limitations, 128 

DMA support, 121 
emulator probe 

cable length, 533 

pin alignment, 146 

target system connection, 142 
emulator status 

displaying, 236 
emulator/analyzer interface 

exiting, 47, 59-60 

running in multiple windows, 53 

starting, 53-56 
enable/disable target system interrupts, 132 
end command, 47, 60, 412 
entry 

pod commands, 92 

simulated io, 238 
entry buffer, 27 

address copy-and-paste to, 69 

clearing, 68 

copy-and-paste from, 72 

copy-and-paste to, 68 

Entry Buffer Recall dialog box, 27 

Entry Buffer Recall dialog box, operation, 71 

multi-window copy-and-paste from, 72 

multi-window copy-and-paste to, 69 

operation, 71 

recall button, 27 



recalling entries, 71 

symbol width and copy-and-paste to, 69 

text entry, 68 

with action keys, 71, 73 

with pulldown menus, 71 
Entry Buffer Recall dialog box operation, 74 
environment variables 

DISPLAY, 575, 578 

HP64000, 575, 579 

KEYMAP, 581 

LD_LIBRARY_PATH, 579-580 
MANPATH, 576, 580 
PATH, 576, 579 

environment variables (UNIX) 
HP64KPATH, 90 
HP64KSYMBPATH, 465 
PATH, 53 

Softkey Interface, setting while in, 229 
environmental characteristics of the emulator, 534 
eram, memory characterization, 121 
erom, memory characterization, 121 
error log 

to file, 236 
error messages, 482 

analyzer, 523 

emulator, 503 

general and system error/status, 510 

Terminal Interface, 503 
error_log 

copy command, 387 

display command, 394 
event log 

to file, 236 
event_log, 57 

copy command, 387 

display command, 395 
EXECUTE 

CMB signal, 338 

tracing at, 343 
exit, emulator/analyzer interface, 47, 59-60 
exiting 



emulation session, 60 

emulator/analyzer windows, 59 
expressions, 251 

-EXPR- syntax, 413-415 
external analyzer 

configuration, 325-333 

general description, 4 

labels, 326, 332 

mode, 328 

should emulation control?, 326 
using, 320 
external data, trace display option, 283 

file 

breakpoints screen to, 235 

data values screen to, 235 

display area to, 235 

editing, 232 

editing at address, 232 

editing at program counter, 232 

editing at symbol from symbols screen, 232 

editing from memory display screen, 232 

emulator configuration, 104 

emulator configuration load, 107 

emulator status screen to, 236 

error log to, 236 

event log to, 236 

global symbols to, 236 

local symbols to, 236 

memory to, 235 

pod commands screen to, 236 

registers to, 235 

trace listing to, 235 
file extensions 

.EA configuration files, 104 
file formats 

address ranges for SPMT measurements, 295 

time ranges for SPMT measurements, 309 
File Selection dialog box operation, 74-75 
firmware updates, 5 
foreground, 112-113, 588 
foreground monitor, 113 
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advantages/disadvantages, 114 

customizing, 113 

emulator modes when using, 113 

example of using, 117 

location of shipped files, 113 

memory space required, 114 

selecting, 112-119 

single-step processor, 116-117 
foreground monitor and vector table, 117 
foreground operation, tracing, 140 
formal parameters (command files), 87 
forward command, syntax, 418 
FRZ asserted by background monitor, 115 
function codes 

driven during background, 135 

mapping memory, 125 

memory mapping, 125 

monitor, 116 

need for separately linked modules, 125 
functions, step over, 219 

G global restart qualifier, 268, 588 
global symbols, 33, 252, 399 

copy command, 387 

display command, 184, 399 

initializing the SPMT measurement with, 295 

to file, 236 
grabbers 

connecting to analyzer probe, 323 
guarded memory accesses, 121, 125, 264 

H halfbright, 79-80 

halt, trace, 247 

hand pointer, 27, 67 

hardware 

HP 9000 memory needs, 550 
HP 9000 minimum performance, 550 
HP 9000 minimums overview, 550 
SPARCsystem memory needs, 551 
SPARCsystem minimum performance, 551 
SPARCsystem minimums overview, 551 

help 
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command line, 82 
copy command, 387 
help index, 77 
on-line, 85 

softkey driven information, 85 
help command, 419-420 
help index, displaying, 77 
hexadecimal numbers, 252 

HP 64700 Operating Environment, minimum version, 
HP 9000 

700 series Motif libraries, 550 

HP-UX minimum version, 550 

installing software, 571 

minimum system requirements overview, 550 
HP 98659 RS-422 Interface Card, 5 
HP-UX, minimum version, 550 
HP64000 environment variable, 575, 579 
HP64KPATH, UNIX environment variable, 90 
HP64KSYMBPATH environment variable, 465 

IACK7 pin, emulator configuration, 135 
IEEE-695 absolute file format, 181 
input 

pod commands, 92 

simulated io, 238 
input scheme, 358, 544 
installation, 550 

hardware, 552 

HP 9000 software, 571 

SPARCsystem software, 577 
instance name, X applications, 539-540 
interactive measurements, 345 
interface 

exiting, 60 
interface, emulator configuration 

exiting, 107 

modifying a section, 102 

starting, 100 
interlock DTACK, 130 
internal 68302 DMA, 128 
interrupt mode, emulator configuration, 132 
interrupts, 114 
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enable/disable from target system, 132 
step command and interrupts during, 115 

inverse assembly syntax, emulator configuration, 111 

inverse video 

graphical interface demo/tutorial files, 368 

inverse video, source line display option, 276 

IRQ7 mode, emulator configuration, 132 

K keyboard 

choosing menu items, 65 

pod commands, 92 

simulated io, 238 
keyboard accelerators, 66 
keyboard focus policy, 66 
keyboard_to_simio, modify command, 426 
KEYMAP environment variable, 581 

L label scheme, 358, 362, 544 
labels 

configuration file, 333 
LANG environment variable, 544 
LD_LIBRARY_PATH environment variable, 579-580 
libraries, Motif for HP 9000/700, 550 
limitations, DMA, 128 

line numbers (source file), symbol display, 185 
line numbers (trace) 

displaying about, 273 
line numbers (trace), displaying about, 272 
lines in main display area, 359-360 
list, trace, 248 
load command, 421-422 

absolute files, 181 

configuration, 422 

trace, 286-287, 422 

trace_spec, 285, 422 
local symbols, 252, 400 

copy command, 389 

display command, 185, 400 

initializing the performance measurement with, 295 

to file, 236 
locked, end command option, 60 
log_commands command, 423 
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MANPATH environment variable, 576, 580 
map command, 126 
mapper ranges, 120 
mapping memory, 120-126 
memory, 390-391 

activity measurements (SPMT), 291, 298 

characterization of, 121 

contents listed as asterisk (*), 390 

copy command, 390-391 

display command, 401-404 

displaying, 218 

displaying at an address, 222 

displaying repetitively, 223 

dual -port emulation, 110 

loading programs into, 181 

mapping, 120-126 

mnemonic format display, 219 

modify command, 427-429 

modifying, 223 

re-assignment of emulation memory blocks in mapper, 124 
store command, 463 
to file, 235 
memory mapping 
block size, 120 

function code specification, 125 
overlaid addresses, 125 
resolution, 120 

using emulation memory in place of target, 126 
memory recommendations 

HP 9000, 550 

SPARCsystem, 551 
memory refresh, 98 
menus 

editing command line with popup, 81 
hand pointer means popup, 27, 67 
pulldown operation with keyboard, 65 
pulldown operation with mouse, 64-65 
messages 
status, 510 

Terminal Interface error, 503 
mixed, slave clock mode, 329 



mnemonic information in trace listing, 275 
mnemonic memory display, 33, 219 

mnemonic memory display, setting the source/symbol modes, 226 

modes, source/symbol, 226 

modify 

registers, 217 
modify command, 424 

configuration, 425 

keyboard_to_simio, 426 

memory, 427-429 

register, 430 

software_breakpoints, 431-432 
modify_command, trace command option, 250 
module duration measurements (SPMT), 306 
module usage measurements (SPMT), 306 
monitor (emulation) 

address of, 116 

foreground monitor filename, 116 
foreground or background, 112-119 
foreground/background comparison, 114 
function code selection, 116 
function of, 112 
selecting, 112-119 

selecting entry after configuration, 109 
Motif, HP 9000/700 requirements, 550 
mouse 

choosing menu items, 65 
mouse buttons, 29 
mouse, choosing menu items, 64 
multi-window 

copy-and-paste from entry buffer, 72 

copy-and-paste to entry buffer, 69 
multiple commands, 83 
multiple emulator start/stop, 5 

name_of_module command, 230 
nesting command files, 86 
NORMAL key, 381, 413 
nosymbols, 183 
notes 

"perf.out" file is in binary format, 316 

68302 internal memory space must be mapped as target RAM, 121 



Index 



breakpoint locations must contain opcodes, 205, 207 

chip select configuration, 137 

CMB EXECUTE and TRIGGER signals, 338 

external timing analyzer does not use configuration labels, 333 

interlock DTACK for correct bus error response, 131 

measurement errors on recursive/multiple entry routines, 307 

only one range resource available, 442 

re-assignment of emulation memory blocks by mapper, 124 

selecting internal clock forces reset, 108 

some compilers emit more than one symbol for an address, 299 
step command doesn't work when CMB enabled, 343 
trigger found but trace memory not filled, 249 
number bases, 251 

number of source lines, trace display option, 276 
numerical values, 251 

O occurrence counts, 259, 266 
octal numbers, 251 
offset by, trace display option, 281 
on-line help, 85 

on_halt, trace command option, 264 
only, trace command storage qualifier, 260 
operating system 

HP 64700 Series minimum version, 551 

HP-UX minimum version, 550 

SunOS minimum version, 551 
operators, 252 
OR0-OR3 registers, 137 
out-of-circuit emulation, 134 
overlaid addresses 

memory mapping, 125 

P parameter passing in command files, 87 
parent symbol 

displaying from symbols screen, 189 
paste mouse button, 29 
PATH environment variable, 576, 579 
PATH, UNIX environment variable, 53 
perf.out, SPMT output file, 296, 310, 315-317, 433 
perf32, SPMT report generator utility, 290, 315-316 

interpreting reports, 298, 311 

options, 317 
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using the, 317 
performance measurements 

See software performance measurements 
performance_measurement_end command, 433 
performance_measurement_initialize command, 434-435 
performance_measurement_run command, 436-437 
physical characteristics of the emulator, 533 
pin extender, 145 
platform 

HP 9000 memory needs, 550 

HP 9000 minimum performance, 550 

SPARCsystem memory needs, 551 

SPARCsystem minimum performance, 551 
platform scheme, 358, 543 
plug-in, 142 

pod commands, 438-439 

copy command, 388 

display command, 395 

display screen, 92 

keyboard input, 92 

screen to file, 236 
popup menus 

command line editing with, 81 

hand pointer indicates presence, 27, 67 
positioning the trace display left/right, 249 
positioning the trace display up/down, 249 
power cables 

connecting, 566 

correct type, 566 
PQFP probe, 148 
prestore, 261 
prestore qualifier, 261 
prestore qualifiers, 261, 588 
primary branches (analyzer sequencer), 588 
probe adapter assembly, 148 
probe characteristics, 528 
processor compatibility, 528 
processor data bus width, 134 
processor type, 54 

program activity measurements (SPMT), 291, 298 
program counter 
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mnemonic memory display, 34 

running from, 194 
pulldown menus 

choosing with keyboard, 65 

choosing with mouse, 64-65 
pushbutton select mouse button, 29 

Q QFP probe, 148 

QUALIFIER, in trace command, 440-441 
qualifiers, 254 

count, 262 

prestore, 261 

simple trigger, 256 

slave clock, 329 

storage, 260 

R RAM, mapping emulation or target, 121 
range resource, note on, 442 
RANGE, in trace command, 442-444 
ranges, memory mapper, 120 
READY, CMB signal, 337 
real-time execution, 588 
real-time runs 

commands not allowed during, 110 

restricting the emulator to, 110 
recall buffer, 27 

columns, 365 

initial content, 365-366 

lines, 365 

recalling entries, 71 
recall, command, 84 

dialog box, 82 
recall, trace specifications dialog box, 250 
recursion in SPMT measurements, 306 
registers 

copy command, 392 

display command, 405 

display/modify, 213-217 

displaying, 216 

modify, 217 

modify command, 430 

modifying BAR and SCR, 121 
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to file, 235 
registers, displaying, 39 
relative count, in the trace display, 280 

relative humidity, operating and non-operating environments, 534 

release_system, end command option, 47, 60, 104 

repetitive display of memory, 223 

reset (emulator), commands which cause exit from, 199 

reset command, 445 

reset SSP and foreground monitor, 133 

reset value for supervisor stack pointer, 133 

reset, run from target, 195 

resolution, memory mapper, 120 

resource 

See X resource 
RESOURCEJVIANAGER property, 542 
restart term, 266, 268 
restrict to real-time runs 

emulator configuration, 110 

permissible commands, 110 

target system dependency, 110 
ROM 

mapping emulation or target, 121 

writes to, 121 
RS-422, host computer interface card, 5 
run command, 194, 446-447 
run from reset, 195 

scheme files (for X resources), 357, 543 

color scheme, 358, 362, 544 

custom, 362-363, 545 

input scheme, 358, 544 

label scheme, 358, 362, 544 

platform scheme, 358, 543 

size scheme, 358, 544 
SCR register, 117, 121 
scroll bar, 27 

secondary branch expression, 588 
select mouse button, 29 
selecting emulation monitor, 112-119 
sequencer (analyzer), 588 

branch, 589 

terms, 266, 588 



using the, 266-270 
SEQUENCING, in trace command, 448-449 
server, X, 356, 542 
set command, 450-454 
shell variables, 88 
sig INT, 315 

signal considerations, 528 
signals, CMB, 337 
simulated I/O, 96, 426 

display command, 406 
simulated io 

displaying screen, 237, 239 

keyboard input, 238 
size scheme, 358, 544 
slave clocks, 329 

Slow clock, emulator status message, 108 
softkey driven help information, 85 
softkey pushbuttons, 27 
softkeys, 83 
software 

installation for HP 9000, 571 

installation for SPARCsystems, 577 
software breakpoints, 200-212 

clearing, 210 

clearing all, 212 

copy command, 388 

deactivating, 207 

display command, 407 

enable/disable, 203 

modify command, 431-432 

opcode locations, 205, 207 

permanent, setting, 205 

re-activating, 208 

ROM code, 200 

selection of TRAP instruction, 139 
setting, 206 
setting all, 207 

setting while running user code, 201 
software breakpoints list, displaying, 202 
software performance measurements, 289, 291-318 

absolute information, 298 



activity measurements, 291-305 
adding traces, 296, 310 
duration, 306-314 
end, 433 
ending, 316 

how they are made, 290 

initialize, 434-435 

initializing, 294, 309 

initializing, default, 294 

initializing, duration measurements, 309 

initializing, user defined ranges, 295, 309 

initializing, with global symbols, 295 

initializing, with local symbols, 295 

memory activity, 291, 298 

module duration, 306 

module usage, 306 

program activity, 291, 298 

recursion, 306 

relative information, 298 

restoring the current measurement, 296, 310 

run, 436-437 

running, 315 

trace command setup, 293 

trace display depth, 293 
source lines 

set command, 453 

symbol display, 185 

trace display, 276 

trace display, number of, 276 
source/symbol modes, setting, 226 
SPARCsystems 

installing software, 577 

minimum system requirements overview, 551 

SunOS minimum version, 551 
specifications, emulator, 528-534 
specify command, 455-456 

SPMT (Software Performance Measurement Tool) 

See software performance measurements 
sq adv, captured sequence state, 267 
SRU (Symbolic Retrieval Utilities), 465-466 
SSP unaffected by target resets during background, 133 



Stack is in guarded memory, error message, 133 

stack pointer (supervisor), reset value, 133 

state, external analyzer mode, 328 

STATE, in trace command, 457-458 

static discharge, protecting the emulator probe against, 143 

status 

copy command, 388 

display command, 244, 395 
status (analyzer state qualifier softkey), 254, 443, 458 

predefined values for, 256 
status line, 27 
status line (display), 57 
status, emulator 

screen to file, 236 
step command, 35, 197-198, 459-460 

interrupts during background monitor execution, 115 
step over, 219 

stop_trace command, 247, 461 
storage qualifiers, 260 
store command, 462-463 
absolute files, 181-182 
store trace command, 286-287 
store trace_spec command, 284 
summary of commands, 382 
SunOS, minimum version, 551 
supervisor stack pointer, reset value, 133 
switching 

directory context in configuration window, 105 

directory context in emulator/analyzer window, 192 

symbol context, 193 
-SYMB- syntax, 464-470 
symbol context 

changing, 193 

displaying, 192 
symbol file, loading, 183 
symbols, 183, 252 

displaying, 183 

displaying parent from symbols screen, 189 
global to file, 236 
local to file, 236 
set command, 453 



-SYMB- syntax, 464-470 

trace display, 278 
synchronous measurements, 343 
syntax conventions, 381 
system requirements 

HP 64700 minimum version, 551 

HP 9000 overview, 550 

HP-UX minimum version, 550 

OSF/Motif HP 9000/700 requirements, 550 

SPARCsystem overview, 551 

SunOS minimum version, 551 

t (start trace) command, 244 

tabs are, source line display option, 276 

target memory 

access size, 134 

loading absolute files, 181 

ROM, symbols for, 183 
target reset, running from, 195 
target system, 589 

dependency on executing code, 110 

interrupts, enable/disable, 132 

plugging the emulator into, 142 

probe installation procedure, 142 

processor signal considerations, 528 

RAM and ROM, 121 
temperatures, operating and non-operating environments, 534 
terminal emulation window, opening, 236 
threshold voltages, 326-327 
time range file format (SPMT measurements), 309 
timing 

external analyzer mode, 328 
trace, 589 

at EXECUTE, 343 
copy command, 393 
depth of, 250 

display command, 408-411 
displaying the, 248 
halting the, 247 
listing the, 248 
listing to file, 235 
load command, 422 



loading, 286-287 

onjialt, 264 

prestore qualifier, 261 

recalling trace specifications, 250 

starting the, 244 

stopping the, 247 

storage qualifier, 260 

storage qualifier with prestore, 261 

store command, 463 

storing, 286-287 

Trace Specification Selection dialog box, 250 
trigger position, 256 
trace command, 471-473 
default, 244 

loading and storing, 284-285 
setting up for SPMT measurements, 293 
trace display, 271-283 

about line numbers, 272-273 
absolute format, 274 
count absolute/relative, 280 
default, 282 

depth, SPMT measurements, 293 

external data, 283 

mnemonic format, 275 

offset by, 281 

positioning, left/right, 249 

positioning, up/down, 249 

source line inclusion, 276 

symbol information inclusion, 278 

width of columns, 279 
trace display, setting the source/symbol modes, 226 
trace signals (emulation analyzer), 253 
trace status display, 244 
trace_spec 

load command, 422 

store command, 463 
tracing background operation, 140 
tram, memory characterization, 121 
transfer address, 195 
TRAP instruction 

selecting for software breakpoints, 139 



Index 



software breakpoints (68302), 200 
trigger, 589 

condition, 256 

position, 256 

position, accuracy of, 257 

specifying a simple, 256 

stop driving on break, 350 
TRIGGER, CMB signal, 337 
TRIGGER, in trace command, 474-475 
trom, memory characterization, 121 
TTL (softkey for specifying threshold voltages), 327 
tutorials 

setting up, 367-369 

U undefined software breakpoint, 200 
uploading memory, 5 

user (target) memory, loading absolute files, 181 
user program, 588 

V values, 251 

predefined for analyzer state qualifiers, 256 
variables (environment) 
DISPLAY, 575, 578 
HP64000, 575, 579 
KEYMAP, 581 

LD_LIBRARY_PATH, 579-580 

MANPATH, 576, 580 

PATH, 576, 579 
vector table, 117, 132 
voltages, threshold, 327 

W wait command, 476-477 

command files, using in, 86 
warnings, power must be OFF during installation, 553 
watchdog timer, 98 
weight of the emulator, 533 
widget resource 

See X resource 
width of columns, trace display option, 279 
window 

exiting emulator/analyzer, 59 
WINDOW, in trace command, 478-479 
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window, terminal emulation, opening, 236 
windows 

opening additional emulator/analyzer, 57 

running the emulator/analyzer interface in multiple, 53 

workstation 

HP 9000 memory needs, 550 
HP 9000 minimum performance, 550 
SPARCsystem memory needs, 551 
SPARCsystem minimum performance, 551 

write to ROM break, 138 

X client, 356 
X resource, 356 

$HP64000/lib/Xl l/HP64_schemes, 545 

$XAPPLRESDIR directory, 542 

$XENVIRONMENT variable, 543 

.Xdefaults file, 542 

app-defaults file, 542 

class name for applications, 540 

class name for widgets, 540 

command line options, 543 

commonly modified graphical interface resources, 358 

defined, 539 

general form, 539 

instance name for applications, 540 

instance name for widgets, 539 

loading order, 542 

modifying resources, generally, 358-361 

RESOURCE_MANAGER property, 542 

scheme file system directory, 545 

scheme files, Graphical User Interface, 543 

scheme files, named, 544 

schemes, forcing interface to use certain, 543 

Softkey .BW, 544 

Softkey .Color, 544 

Softkey .Input, 544 

Softkey .Label, 544 

Softkey .Large, 544 

Softkey .Small, 544 

wildcard character, 540 

xrdb, 542 

xrm command line option, 543 



X server, 356, 542 

X Window System, 53 

xbits, external analyzer label, 332 

XEnv_68k_except symbol and effect on breakpoionts, 203 



Certification and Warranty 



Certification 

Hewlett-Packard Company certifies that this product met its published 
specifications at the time of shipment from the factory. Hewlett-Packard further 
certifies that its calibration measurements are traceable to the United States 
National Bureau of Standards, to the extent allowed by the Bureau's calibration 
facility, and to the calibration facilities of other International Standards 
Organization members. 



Warranty 

This Hewlett-Packard system product is warranted against defects in materials and 
workmanship for a period of 90 days from date of installation. During the warranty 
period, HP will, at its option, either repair or replace products which prove to be 
defective. 

Warranty service of this product will be performed at Buyer's facility at no charge 
within HP service travel areas. Outside HP service travel areas, warranty service 
will be performed at Buyer's facility only upon HP's prior agreement and Buyer 
shall pay HP's round trip travel expenses. In all other cases, products must be 
returned to a service facility designated by HP. 

For products returned to HP for warranty service, Buyer shall prepay shipping 
charges to HP and HP shall pay shipping charges to return the product to Buyer. 
However, Buyer shall pay all shipping charges, duties, and taxes for products 
returned to HP from another country. HP warrants that its software and firmware 
designated by HP for use with an instrument will execute its programming 
instructions when properly installed on that instrument. HP does not warrant that 
the operation of the instrument, or software, or firmware will be uninterrupted or 
error free. 



Limitation of Warranty 



The foregoing warranty shall not apply to defects resulting from improper or 
inadequate maintenance by Buyer, Buyer-supplied software or interfacing, 
unauthorized modification or misuse, operation outside of the environment 
specifications for the product, or improper site preparation or maintenance. 

No other warranty is expressed or implied. HP specifically disclaims the 
implied warranties of merchantability and fitness for a particular purpose. 

Exclusive Remedies 

The remedies provided herein are buyer's sole and exclusive remedies. HP 
shall not be liable for any direct, indirect, special, incidental, or consequential 
damages, whether based on contract, tort, or any other legal theory. 

Product maintenance agreements and other customer assistance agreements are 
available for Hewlett-Packard products. 

For any assistance, contact your nearest Hewlett-Packard Sales and Service Office. 



Safety 



Summary of Safe Procedures 

The following general safety precautions must be observed during all phases of 
operation, service, and repair of this instrument. Failure to comply with these 
precautions or with specific warnings elsewhere in this manual violates safety 
standards of design, manufacture, and intended use of the instrument. 
Hewlett-Packard Company assumes no liability for the customer's failure to 
comply with these requirements. 



Ground The Instrument 

To minimize shock hazard, the instrument chassis and cabinet must be connected to 
an electrical ground. The instrument is equipped with a three-conductor ac power 
cable. The power cable must either be plugged into an approved three-contact 
electrical outlet or used with a three -contact to two-contact adapter with the 
grounding wire (green) firmly connected to an electrical ground (safety ground) at 
the power outlet. The power jack and mating plug of the power cable meet 
International Electrotechnical Commission (IEC) safety standards. 



Do Not Operate In An Explosive Atmosphere 

Do not operate the instrument in the presence of flammable gases or fumes. 
Operation of any electrical instrument in such an environment constitutes a definite 
safety hazard. 



Keep Away From Live Circuits 

Operating personnel must not remove instrument covers. Component replacement 
and internal adjustments must be made by qualified maintenance personnel. Do not 
replace components with the power cable connected. Under certain conditions, 
dangerous voltages may exist even with the power cable removed. To avoid 
injuries, always disconnect power and discharge circuits before touching them. 



Do Not Service Or Adjust Alone 



Do not attempt internal service or adjustment unless another person, capable of 
rendering first aid and resuscitation, is present. 

Do Not Substitute Parts Or Modify Instrument 

Because of the danger of introducing additional hazards, do not install substitute 
parts or perform any unauthorized modification of the instrument. Return the 
instrument to a Hewlett-Packard Sales and Service Office for service and repair to 
ensure that safety features are maintained. 

Dangerous Procedure Warnings 

Warnings, such as the example below, precede potentially dangerous procedures 
throughout this manual. Instructions contained in the warnings must be followed. 

Dangerous voltages, capable of causing death, are present in this instrument. Use 
extreme caution when handling, testing, and adjusting. 



Safety Symbols Used In Manuals 

The following is a list of general definitions of safety symbols used on equipment 
or in manuals: 

Instruction manual symbol: the product is marked with this symbol when it is 
necessary for the user to refer to the instruction manual in order to protect against 
damage to the instrument. 

Indicates dangerous voltage (terminals fed from the interior by voltage exceeding 
1000 volts must be marked with this symbol). 

Protective conductor terminal. For protection against electrical shock in case of a 
fault. Used with field wiring terminals to indicate the terminal which must be 
connected to ground before operating the equipment. 

Low-noise or noiseless, clean ground (earth) terminal. Used for a signal common, 
as well as providing protection against electrical shock in case of a fault. A terminal 
marked with this symbol must be connected to ground in the manner described in 
the installation (operating) manual before operating the equipment. 

"rame or chassis terminal. A connection to the frame (chassis) of the equipment 
'hich normally includes all exposed metal structures. 

Alternating current (power line). 

Direct current (power line). 



Alternating or direct current (power line). 



The Caution sign denotes a hazard. It calls your attention to an operating procedure, 
practice, condition, or similar situation, which, if not correctly performed or 
adhered to, could result in damage to or destruction of part or all of the product. 



The Warning sign denotes a hazard. It calls your attention to a procedure, practice, 
condition or the like, which, if not correctly performed, could result in injury or 
death to personnel. 



